Partager via


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

Retourne les ID de classe des effets actuellement inscrits et des effets globaux sur cette fabrique.

Syntaxe

HRESULT GetRegisteredEffects(
  [out]           CLSID  *effects,
                  UINT32 effectsCount,
  [out]           UINT32 *effectsReturned,
  [out, optional] UINT32 *effectsRegistered
);

Paramètres

[out] effects

Type : CLSID*

Lorsque cette méthode retourne, contient un tableau d’effets. NULL si aucun effet n’est récupéré.

effectsCount

Type : UINT32

Capacité du tableau d’effets .

[out] effectsReturned

Type : UINT32*

Lorsque cette méthode retourne, contient le nombre d’effets copiés dans les effets.

[out, optional] effectsRegistered

Type : UINT32*

Lorsque cette méthode retourne, contient le nombre d’effets actuellement enregistrés dans le système.

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.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) effectsRegistered est plus grand que effectCount.

Remarques

Le jeu d’ID de classe sera retourné de manière atomique par l’API. Le jeu ne sera pas interrompu par d’autres threads qui inscrivent ou annulent l’inscription des effets.

Si effectsRegistered est supérieur à effectCount, le tableau fourni est toujours rempli à capacité avec l’ensemble actuel d’effets inscrits. Cette méthode retourne les CLSID pour tous les effets globaux et tous les effets enregistrés dans cette fabrique.

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 ::RegisterEffect