ID2D1Properties::GetValueByName(PCWSTR,BYTE*,UINT32)-Methode (d2d1_1.h)

Ruft den Eigenschaftswert nach Name ab.

Syntax

HRESULT GetValueByName(
  [in]  PCWSTR name,
  [out] BYTE   *data,
        UINT32 dataSize
);

[in] name

Typ: PCWSTR

Der abzurufende Eigenschaftsname.

[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.

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.

Wenn der Name nicht vorhanden ist, werden keine Informationen abgerufen.

Alle Fehler, die nicht im Standardsatz von einer Eigenschaftenimplementierung zurückgegeben werden, werden dem Standardfehlerbereich zugeordnet.


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