Fonction D3DKMTEnumAdapters3 (d3dkmthk.h)

  • Article

Fournit des informations pour l’énumération des graphiques et des cartes d’affichage sur le système.

Syntaxe

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

Paramètres

[in/out] unnamedParam1

Structure D3DKMT_ENUMADAPTERS3 . L’appelant transmet la taille du tableau et un espace de tableau vide. L’appelé vérifie qu’il y a suffisamment d’espace dans le tableau, remplit le tableau et retourne la quantité du tableau utilisée.

Valeur retournée

Cette fonction retourne NTSTATUS.

Code de retour Description
STATUS_BUFFER_TOO_SMALL Le tableau fourni est trop petit pour recevoir toutes les cartes.
STATUS_INVALID_PARAMETER Le membre pEnumAdapters est 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

Lorsque D3DKMT_ENUMADAPTERS3 ::p Adapters a la valeur Null, D3DKMT_ENUMADAPTERS3 ::NumAdapters est défini sur le nombre maximal d’adaptateurs pris en charge. Les personnes appelées appellent généralement la méthode, tout d’abord, pour récupérer le nombre maximal d’adaptateurs pris en charge.

Lorsque l’appelé énumère correctement les cartes, il devient responsable de la gestion explicite de la durée de vie de l’adaptateur D3DKMT_HANDLEs. Ces handles sont retournés à l’appelé via pEnumAdapters, et ils doivent être fermés avec D3DKMTCloseAdapter.

La définition d’aucun indicateur D3DKMT_ENUMADAPTERS3 ::Filter n’énumère toujours les adaptateurs, mais il y a moins d’adaptateurs que D3DKMTEnumAdapters2 énuméré. Les adaptateurs ComputeOnly sont laissés en dehors de l’énumération par défaut, afin d’éviter les applications cassants. Les adaptateurs DisplayOnly sont également laissés en dehors de l’énumération par défaut.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004
Plateforme cible Windows
En-tête d3dkmthk.h (inclure D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

PFND3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter