Freigeben über


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

Ruft den Eigenschaftswert anhand des Namens ab. Dies ist eine Vorlagenüberladung. Siehe Anmerkungen.

Syntax

HRESULT GetValueByName(
  [in]  PCWSTR propertyName,
  [out] T      *value
);

Parameter

[in] propertyName

Typ: PCWSTR-

Der abzurufende Eigenschaftsname.

[out] value

Typ: T*

Wenn diese Methode zurückgegeben wird, enthält sie den Wert.

Rückgabewert

Typ: HRESULT-

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

HRESULT Beschreibung
S_OK Es ist kein Fehler aufgetreten.
D2DERR_INVALID_PROPERTY Die angegebene Eigenschaft ist nicht vorhanden.
E_OUTOFMEMORY Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
D3DERR_OUT_OF_VIDEO_MEMORY Fehler beim Zuordnen des erforderlichen Videospeichers.
E_INVALIDARG Mindestens ein Argument ist ungültig.
E_FAIL Nicht angegebener Fehler.

Bemerkungen

Wenn propertyName- nicht vorhanden ist, werden keine Informationen abgerufen.

Jeder Fehler, der nicht im von einer Eigenschaftsimplementierung zurückgegebenen Standardsatz ist, wird dem Standardfehlerbereich zugeordnet.

template<typename T>
    HRESULT GetValueByName(
        _In_ PCWSTR propertyName,
        _Out_ T *value
        ) const;

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform- Fenster
Header- d2d1_1.h
Library D2d1.lib
DLL- D2d1.dll

Siehe auch

ID2D1DeviceContext::CreateEffect

ID2D1Properties-