D3DKMTEnumAdapters2, fonction (d3dkmthk.h)

  • Article

La fonction D3DKMTEnumAdapters2 fournit des informations pour l’énumération de tous les graphiques et cartes graphiques 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. Consultez la section Notes.

Valeur de retour

D3DKMTEnumAdapters2 retourne STATUS_SUCCESS en cas de réussite ou une erreur telle que l’une des suivantes.

Code de retour 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 est 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 pouvant être retournés dans le tableau vide vers lequel pAdapters pointe. Au retour, si D3DKMT_ENUMADAPTERS2 retourne STATUS_SUCCESS :

  • Si pAdapters n’a pas la valeur NULL, NumAdapters contient le nombre d’adaptateurs retournés dans le tableau pAdapters .
  • Si pAdapters a la valeur NULL, NumAdapters contient 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é 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 qu’il pointe vers un tableau de structures numAdaptersD3DKMT_ENUMADAPTERS2 . D3DKMTEnumAdapters2 remplit le tableau et transmet le nombre de structures de tableau (adaptateurs) qu’il 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 par le biais de pAdapters et doivent être fermés avec D3DKMTCloseAdapter.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
Plateforme cible Windows
En-tête d3dkmthk.h (include D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter