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

Article
08/22/2023

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