D3DKMTEnumAdapters3, fonction (d3dkmthk.h)
Fournit des informations pour énumérer les graphiques et les adaptateurs d’affichage sur le système.
Syntaxe
NTSTATUS D3DKMTEnumAdapters3(
[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 ils doivent être fermés avec D3DKMTCloseAdapter.
La définition d’aucun des indicateurs D3DKMT_ENUMADAPTERS3 ::Filter n’énumère toujours les adaptateurs, mais il existe moins d’adaptateurs que D3DKMTEnumAdapters2 énumère. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10, version 2004 |
| plateforme cible | Windows |
| d’en-tête | d3dkmthk.h (include D3dkmthk.h) |
| bibliothèque | onecoreuap.lib |
| DLL | Gdi32.dll |