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