ID2D1DeviceContext::CreateEffect, méthode (d2d1_1.h)
Crée un effet pour l’ID de classe spécifié.
Syntaxe
HRESULT CreateEffect(
REFCLSID effectId,
[out] ID2D1Effect **effect
);
Paramètres
effectId
Type : REFCLSID
ID de classe de l’effet à créer. Pour obtenir la liste des ID d’effet, consultez Effets intégrés .
[out] effect
Type : ID2D1Effect**
Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers un nouvel effet.
Valeur retournée
Type : HRESULT
Cette méthode 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. |
| E_NOTFOUND | Autres HRESULT possibles pour un effet qui n’est pas inscrit (comme D2DERR_EFFECT_IS_NOT_REGISTERED). |
| D2DERR_INSUFFICIENT_DEVICE_CAPABILITIES | L’effet nécessite des fonctionnalités non prises en charge par l’appareil D2D. |
Remarques
Si l’effet créé est un effet personnalisé implémenté dans une DLL, cela n’incrémente pas le nombre de références pour cette DLL. Si l’application supprime 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 Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | d2d1_1.h |
| DLL | D2d1.dll |