DXGKDDI_QUERYADAPTERINFO fonction de rappel (d3dkmddi.h)
Dxgkrnl appelle la fonction d'DxgkDdiQueryAdapterInfo du pilote miniport d’affichage pour récupérer 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 STATUS_SUCCESS lorsqu’elle récupère correctement les informations de configuration. Sinon, elle retourne un code NTSTATUS tel que l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| STATUS_INVALID_PARAMETER | Un ou plusieurs paramètres passés 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 KMD n’est pas compatible avec le pilote d’affichage en mode utilisateur (UMD) qui a lancé l’appel à DxgkDdiQueryAdapterInfo (autrement dit, fourni des données privées pour une requête au KMD). |
Remarques
Lorsque l’UMD appelle le rappel pfnQueryAdapterInfoCb du runtime Direct3D, un appel à la fonction DxgkDdiQueryAdapterInfo est lancé.
Si Dxgkrnl spécifie DXGKQAITYPE_UMDRIVERPRIVATE dans DXGKARG_QUERYADAPTERINFO ::Type, pOutputData pointe vers une structure propriétaire que KMD remplit avec les informations de configuration nécessaires à l’UMD pour identifier l’adaptateur.
Si Dxgkrnl spécifie DXGKQAITYPE_DRIVERCAPS dans DXGKARG_QUERYADAPTERINFO ::Type, le KMD doit remplir la structure DXGK_DRIVERCAPS fournie avec les informations que le sous-système peut utiliser.
Si Dxgkrnl spécifie DXGKQAITYPE_QUERYSEGMENT dans DXGKARG_QUERYADAPTERINFO ::Type, le KMD 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 (WDDM 1.0) |
| plateforme cible | Bureau |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |