DXGKDDI_QUERYADAPTERINFO fonction de rappel (d3dkmddi.h)
Le miniport d’affichage (KMD’s) DxgkDdiQueryAdapterInfo fonction 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 pour 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 de retour
DxgkDdiQueryAdapterInfo retourne l’une des valeurs suivantes :
| Retourner le code | 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 de mémoire nécessaire pour qu’elle se termine. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Le pilote display miniport 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 le paramètre pQueryAdapterInfo pointe, pOutputData pointe vers une structure propriétaire remplie 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 de miniport d’affichage doit remplir la structure DXGK_DRIVERCAPS fournie avec des informations que le sous-système peut utiliser.
Si le sous-système du noyau graphique DirectX fournit la valeur DXGKQAITYPE_QUERYSEGMENT dans le Type membre 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.
Tous les pilotes qui prennent en charge WDDM 2.6 et versions ultérieures doivent implémenter le rappel DxgkDdiQueryAdapterInfo.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |