D3DKMTEnumAdapters2, fonction (d3dkmthk.h)
La fonction D3DKMTEnumAdapters2 fournit des informations pour énumérer tous les graphiques et adaptateurs d’affichage sur le système.
Syntaxe
NTSTATUS D3DKMTEnumAdapters2(
const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);
Paramètres
unnamedParam1
[in, out] Pointeur vers une structure D3DKMT_ENUMADAPTERS2 dans laquelle fournir des informations sur les adaptateurs sur le système. Voir les remarques.
Valeur de retour
D3DKMTEnumAdapters2 retourne STATUS_SUCCESS en cas de réussite ou d’erreur telle que l’une des suivantes.
| Retour du code | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | Le tableau fourni est trop petit pour recevoir tous les adaptateurs. |
| STATUS_INVALID_PARAMETER | pAdapters a la valeur NULL ou n’est pas une région de mémoire non valide. |
| STATUS_NO_MEMORY | La mémoire ne peut pas être allouée pour satisfaire l’opération. |
Remarques
Lors de l’entrée, NumAdapters spécifie le nombre d’adaptateurs à retourner dans le tableau vide vers lequel pAdapters points. En retour, si D3DKMT_ENUMADAPTERS2 retourne STATUS_SUCCESS :
- Si pAdapters n’a pas la valeur NULL, NumAdapters contiendra le nombre d’adaptateurs retournés dans le tableau pAdapters.
- Si pAdapters a la valeur NULL, NumAdapters contiendra le nombre maximal d’adaptateurs pris en charge.
Si D3DKMT_ENUMADAPTERS2 retourne une erreur, NumAdapters n’est pas défini.
D3DKMTEnumAdapters2 est généralement appelée deux fois :
Pour le premier appel, définissez pAdapters sur NULL. D3DKMTEnumAdapters2 écrit le nombre maximal d’adaptateurs pris en charge dans NumAdapters.
Pour le deuxième appel, définissez NumAdapters sur la valeur retournée dans le premier appel et définissez pAdapters pour pointer vers un tableau de structures D3DKMT_ENUMADAPTERS2 NumAdapters. D3DKMTEnumAdapters2 remplira le tableau et transmet le nombre de structures de tableau (adaptateurs) qu’elle a remplies.
Une fois que l’appelant de D3DKMTEnumAdapters2 a reçu une énumération des adaptateurs, il incombe à l’appelant de gérer la durée de vie de l’adaptateur D3DKMT_HANDLEs. Ces handles sont retournés via pAdapters et doivent être fermés avec D3DKMTCloseAdapter .
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Windows |
| En-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |