PFND3DKMT_ENUMADAPTERS3 fonction de rappel (d3dkmthk.h)

2025-02-06

La fonction de rappel PFND3DKMT_ENUMADAPTERS3 énumère les graphiques et les adaptateurs 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 passe la taille du tableau et un espace de tableau vide. L’appelé vérifie qu’il y a suffisamment de place dans le tableau, remplit le tableau et retourne la quantité de tableau utilisée.

Valeur de retour

Cette fonction retourne NTSTATUS.

Retour du code	Description
STATUS_BUFFER_TOO_SMALL	Le tableau fourni est trop petit pour recevoir tous les adaptateurs.
STATUS_INVALID_PARAMETER	Le membre pEnumAdapters a la valeur Null ou est sinon 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 appelé appellent généralement la méthode, d’abord, pour récupérer le nombre maximal d’adaptateurs pris en charge.

Lorsque l’appelé énumère correctement les adaptateurs, 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 indicateur D3DKMT_ENUMADAPTERS3 ::Filter n’énumère toujours les adaptateurs, mais il existe moins d’adaptateurs que PFND3DKMT_ENUMADAPTERS2 énumérations. Les adaptateurs ComputeOnly sont laissés hors de l’énumération par défaut, pour éviter les applications cassantes. Les adaptateurs DisplayOnly sont également laissés hors de l’énumération par défaut.