ID2D1Factory1 ::GetEffectProperties, méthode (d2d1_1.h)

  • Article

Récupère les propriétés d’un effet.

Syntaxe

HRESULT GetEffectProperties(
  [in]  REFCLSID        effectId,
  [out] ID2D1Properties **properties
);

Paramètres

[in] effectId

Type : REFCLSID

ID de l’effet à partir duquel récupérer les propriétés.

[out] properties

Type : ID2D1Properties**

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers l’interface de propriété qui peut être utilisé pour interroger les métadonnées de l’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.
D2DERR_EFFECT_IS_NOT_REGISTERED L’effet demandé est introuvable.
E_OUTOFMEMORY Direct2D n’a pas pu allouer suffisamment de mémoire pour terminer l’appel.

Remarques

Les propriétés d’effet retournées auront toutes les propriétés mutables de l’effet définies sur la valeur par défaut NULL ou une valeur vide.

  • Les types valeur sont vides.
  • Les types d’objets blob et de chaîne seront de longueur nulle.
  • Les types de tableaux auront une longueur 1 et l’élément du tableau sera conforme aux règles précédentes.
Cette méthode ne peut pas être utilisée pour retourner les propriétés d’un effet non visible pour ID2D1DeviceContext ::CreateEffect.

Configuration requise

Condition requise Valeur
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 d2d1_1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1Factory1

ID2D1Factory1 ::GetRegisteredEffects

ID2D1Factory1 ::RegisterEffect