ID2D1EffectContext::CreateEffect, méthode (d2d1effectauthor.h)
Crée un effet Direct2D pour l’ID de classe spécifié. Il s’agit de la même chose que ID2D1DeviceContext::CreateEffect afin que les effets personnalisés puissent créer d’autres effets et les envelopper dans une transformation.
Syntaxe
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Paramètres
effectId
Type : REFCLSID
ID d’effet intégré ou inscrit pour créer l’effet. Pour obtenir la liste des ID d’effet , consultez Effets intégrés .
[out] effect
Type : ID2D1Effect**
Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers l’effet.
Valeur retournée
Type : HRESULT
Elle retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| HRESULT | Description |
|---|---|
| S_OK | Aucune erreur ne s'est produite. |
| E_OUTOFMEMORY | Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel. |
| E_INVALIDARG | Une valeur non valide a été passée à la méthode. |
| D3DERR_OUTOFVIDEOMEMORY | Direct3D n’a pas suffisamment de mémoire d’affichage pour effectuer l’opération. |
| D2DERR_EFFECT_IS_NOT_REGISTERED | L’effet spécifié n’est pas inscrit par le système. |
Remarques
L’effet créé ne fait pas référence au nombre de dll à partir de laquelle l’effet a été créé. Si l’appelant annule l’inscription d’un effet pendant le chargement de cet effet, le comportement résultant est imprévisible.
Configuration requise
| Client minimal pris en charge | Windows 8 et Mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 et mise à jour de plateforme pour Windows Server 2008 R2 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | d2d1effectauthor.h |
| Bibliothèque | D2D1.lib |