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 |