Partager via


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

Voir aussi

Effets

ID2D1DeviceContext

ID2D1Effect

ID2D1Factory1::RegisterEffect