Partager via

DXGKDDI_QUERYADAPTERINFO fonction de rappel (d3dkmddi.h)

  • Article

La fonction DxgkDdiQueryAdapterInfo du miniport d’affichage (KMD) 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 vers un bloc de contexte associé à un adaptateur d’affichage. Le KMD a précédemment fourni ce handle à Dxgkrnl dans le paramètre de sortie MiniportDeviceContext de la fonction DxgkDdiAddDevice .

[in] pQueryAdapterInfo

Pointeur vers une structure DXGKARG_QUERYADAPTERINFO que le KMD 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 correctement 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 pour qu’il se termine.
STATUS_GRAPHICS_DRIVER_MISMATCH Le pilote de miniport d’affichage n’est pas compatible avec le pilote d’affichage en mode utilisateur qui a lancé l’appel à DxgkDdiQueryAdapterInfo (autrement dit, 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é.

Si DxgkDdiQueryAdapterInfo reçoit la valeur DXGKQAITYPE_UMDRIVERPRIVATE dans le membre Type de la structure DXGKARG_QUERYADAPTERINFO vers laquelle pointe le paramètre pQueryAdapterInfo , pOutputData pointe vers une structure propriétaire que KMD remplit avec les informations de configuration nécessaires pour que le pilote d’affichage en mode utilisateur identifie l’adaptateur.

Si Dxgkrnl 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 de 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.

Tous les pilotes qui prennent en charge WDDM 2.6 et ultérieur 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