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

Weitere Informationen

ID2D1DeviceContext::CreateEffect

ID2D1Eigenschaften