DXGKDDI_QUERYADAPTERINFO fonction de rappel (d3dkmddi.h)

  • Article

La fonction DxgkDdiQueryAdapterInfo récupère les informations de configuration de la carte graphique.

Syntaxe

DXGKDDI_QUERYADAPTERINFO DxgkddiQueryadapterinfo;

NTSTATUS DxgkddiQueryadapterinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_QUERYADAPTERINFO pQueryAdapterInfo
)
{...}

Paramètres

[in] hAdapter

Handle d’un bloc de contexte associé à une carte d’affichage. Le pilote miniport d’affichage a précédemment fourni cette poignée au sous-système du noyau graphique Microsoft DirectX dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Pointeur vers une structure DXGKARG_QUERYADAPTERINFO que le pilote miniport d’affichage remplit avec les informations de configuration de la carte graphique.

Valeur retournée

DxgkDdiQueryAdapterInfo retourne l’une des valeurs suivantes :

Code de retour Description
STATUS_SUCCESS DxgkDdiQueryAdapterInfo a récupéré les informations de configuration.
STATUS_INVALID_PARAMETER Les paramètres passés à DxgkDdiQueryAdapterInfo contenaient des erreurs qui l’empêchaient de se terminer.
STATUS_NO_MEMORY DxgkDdiQueryAdapterInfo n’a pas pu allouer la mémoire nécessaire à sa fin.
STATUS_GRAPHICS_DRIVER_MISMATCH Le pilote miniport d’affichage n’est pas compatible avec le pilote d’affichage en mode utilisateur qui a lancé l’appel à DxgkDdiQueryAdapterInfo (c’est-à-dire, fourni des données privées pour une requête au pilote miniport d’affichage).

Remarques

Lorsque le pilote d’affichage en mode utilisateur appelle la fonction pfnQueryAdapterInfoCb , un appel à la fonction DxgkDdiQueryAdapterInfo est lancé. DxgkDdiQueryAdapterInfo reçoit la valeur DXGKQAITYPE_UMDRIVERPRIVATE dans le membre Type de la structure DXGKARG_QUERYADAPTERINFO vers laquelle pointe le paramètre pQueryAdapterInfo . Cette fonction reçoit également une mémoire tampon propriétaire dans le membre pOutputData qu’elle remplit avec les informations de configuration nécessaires pour que le pilote d’affichage en mode utilisateur identifie l’adaptateur.

Si le sous-système du noyau graphique DirectX (qui fait partie de Dxgkrnl.sys) spécifie la valeur DXGKQAITYPE_DRIVERCAPS dans le membre Type de DXGKARG_QUERYADAPTERINFO lorsque le sous-système appelle DxgkDdiQueryAdapterInfo, le pilote miniport d’affichage doit remplir la structure de DXGK_DRIVERCAPS fournie avec les informations que le sous-système peut utiliser.

Si le sous-système du noyau graphique DirectX fournit la valeur DXGKQAITYPE_QUERYSEGMENT dans le membre Type de DXGKARG_QUERYADAPTERINFO, le pilote miniport d’affichage doit fournir des informations sur les segments de mémoire qu’il prend en charge. Pour plus d’informations sur les segments de mémoire, consultez Initialisation de l’utilisation des segments de mémoire.

DxgkDdiQueryAdapterInfo doit être rendu paginable.

Notes

Tous les pilotes qui prennent en charge WDDM 2.6 doivent implémenter le rappel DxgkDdiQueryAdapterInfo.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARG_QUERYADAPTERINFO

DxgkDdiAddDevice

pfnQueryAdapterInfoCb