ID2D1DeviceContext::CreateEffect-Methode (d2d1_1.h)

Erstellt einen Effekt für die angegebene Klassen-ID.

Syntax

HRESULT CreateEffect(
        REFCLSID    effectId,
  [out] ID2D1Effect **effect
);

Parameter

effectId

Typ: REFCLSID

Die Klassen-ID des zu erstellenden Effekts. Eine Liste der Effekt-IDs finden Sie unter Integrierte Effekte .

[out] effect

Typ: ID2D1Effect**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf einen neuen Effekt.

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.
E_OUTOFMEMORY	Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG	Ein ungültiger Wert wurde an die -Methode übergeben.
D3DERR_OUTOFVIDEOMEMORY	Direct3D verfügt nicht über genügend Anzeigespeicher, um den Vorgang auszuführen.
D2DERR_EFFECT_IS_NOT_REGISTERED	Der angegebene Effekt wird vom System nicht registriert.
E_NOTFOUND	Andere mögliche HRESULT für einen Effekt, der nicht registriert wird (z. B. D2DERR_EFFECT_IS_NOT_REGISTERED).
D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES	Der Effekt erfordert Funktionen, die vom D2D-Gerät nicht unterstützt werden.

Hinweise

Wenn der erstellte Effekt ein benutzerdefinierter Effekt ist, der in einer DLL implementiert ist, wird die Verweisanzahl für diese DLL nicht erhöht. Wenn die Anwendung einen Effekt löscht, während dieser Effekt geladen wird, ist das resultierende Verhalten unvorhersehbar.

Anforderungen

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
DLL	D2d1.dll

Weitere Informationen

Effekte

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect