PFND3DKMT_ENUMADAPTERS3 fonction de rappel (d3dkmthk.h)

Article
02/23/2024

La fonction de rappel PFND3DKMT_ENUMADAPTERS3 énumère les graphiques et les cartes d’affichage sur le système.

Syntaxe

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [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 doivent être fermés avec D3DKMTCloseAdapter.

La définition d’aucun des indicateurs D3DKMT_ENUMADAPTERS3 ::Filter n’énumère toujours les adaptateurs, mais il y a moins d’adaptateurs que PFND3DKMT_ENUMADAPTERS2 énumère. 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.