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 |