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 |