ID2D1EffectContext::CreateEffect-Methode (d2d1effectauthor.h)

Erstellt einen Direct2D-Effekt für die angegebene Klassen-ID. Dies ist identisch mit ID2D1DeviceContext::CreateEffect , sodass benutzerdefinierte Effekte andere Effekte erstellen und in einer Transformation umschließen können.

Syntax

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

Parameter

effectId

Typ: REFCLSID

Die integrierte oder registrierte Effekt-ID zum Erstellen des 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 den 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.

Hinweise

Der erstellte Effekt verweist nicht auf die Zählung der DLL, aus der der Effekt erstellt wurde. Wenn der Aufrufer die Registrierung eines Effekts aufhebt, 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	d2d1effectauthor.h
Bibliothek	D2D1.lib

Weitere Informationen

D2D1_BLEND_DESCRIPTION

Effekte

ID2D1BlendTransform

ID2D1EffectContext