Freigeben über

ID2D1Factory1::GetEffectProperties-Methode (d2d1_1.h)

Ruft die Eigenschaften eines Effekts ab.

Syntax

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Parameter

[in] effectId

Typ: REFCLSID

Die ID des Effekts, aus dem Eigenschaften abgerufen werden sollen.

[out] properties

Typ: ID2D1Properties**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die Eigenschaftenschnittstelle, die verwendet werden kann, um die Metadaten des Effekts abzufragen.

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_EFFECT_IS_NOT_REGISTERED Der angeforderte Effekt konnte nicht gefunden werden.
E_OUTOFMEMORY Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Aufruf abzuschließen.

Hinweise

Für die zurückgegebenen Effekteigenschaften sind alle veränderlichen Eigenschaften für den Effekt auf den Standardwert NULL oder einen leeren Wert festgelegt.

  • Werttypen werden mit Null gefüllt.
  • Blob- und Zeichenfolgentypen haben die Länge null.
  • Arraytypen haben die Länge 1, und das Element des Arrays entspricht den vorherigen Regeln.
Diese Methode kann nicht verwendet werden, um die Eigenschaften für einen Effekt zurückzugeben, der für ID2D1DeviceContext::CreateEffect nicht sichtbar ist.

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

ID2D1Factory1

ID2D1Factory1::GetRegisteredEffects

ID2D1Factory1::RegisterEffect

  • Last updated on