DXGKDDI_QUERYADAPTERINFO fonction de rappel (d3dkmddi.h)
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 |