ID2D1Properties::GetValueByName(PCWSTR,D2D1_PROPERTY_TYPE,BYTE*,UINT32)-Methode (d2d1_1.h)
Ruft den Eigenschaftswert anhand des Namens ab.
Syntax
HRESULT GetValueByName(
[in] PCWSTR name,
D2D1_PROPERTY_TYPE type,
[out] BYTE *data,
UINT32 dataSize
);
Parameter
[in] name
Typ: PCWSTR
Der abzurufende Eigenschaftsname.
type
TBD
[out] data
Typ: BYTE*
Wenn diese Methode zurückgibt, enthält den Puffer mit dem Datenwert.
dataSize
Typ: UINT32
Die Anzahl der Bytes in den abzurufenden Daten.
Rückgabewert
Typ: HRESULT
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Kein Fehler ist aufgetreten. |
| D2DERR_INVALID_PROPERTY | Die angegebene Eigenschaft ist nicht vorhanden. |
| E_OUTOFMEMORY | Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. |
| D3DERR_OUT_OF_VIDEO_MEMORY | Fehler beim Zuweisen des erforderlichen Videospeichers. |
| E_INVALIDARG | Mindestens ein Argument ist ungültig. |
| E_FAIL | Unspezifizierter Fehler. |
Hinweise
Wenn der Name nicht vorhanden ist, werden keine Informationen abgerufen.
Alle Fehler, die nicht im Standardsatz enthalten sind, der von einer Eigenschaftsimplementierung zurückgegeben wird, werden dem Standardfehlerbereich zugeordnet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| Bibliothek | D2d1.lib |
| DLL | D2d1.dll |