DXGKDDI_QUERY_INTERFACE fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkDdiQueryInterface retourne une interface fonctionnelle implémentée par le pilote miniport d’affichage.

Syntaxe

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte associé à un adaptateur d’affichage. La fonctiondu pilote miniport d’affichage DxgkDdiAddDevice a précédemment fourni ce handle pour Dxgkrnl.

[in] QueryInterface

Pointeur vers une structure QUERY_INTERFACE dans laquelle le pilote miniport d’affichage doit retourner des informations sur l’interface qu’il prend en charge.

Valeur de retour

DxgkDdiQueryInterface retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne un code NTSTATUS approprié. Si un pilote miniport d’affichage ne prend pas en charge l’interface demandée, il doit retourner STATUS_NOT_SUPPORTED. En retournant STATUS_NOT_SUPPORTED, le pilote display miniport informe le système d’exploitation de passer la requête au pilote suivant.

Remarques

DxgkDdiQueryInterface expose un mécanisme de communication entre le pilote miniport d’affichage et le pilote d’un appareil enfant (par exemple, un périphérique de capture vidéo). Un pilote miniport d’affichage qui expose un tel mécanisme doit implémenter cette fonction.

DxgkDdiQueryInterface doit renseigner les membres de la structureinterfacequi QueryInterface->Interface pointe comme suit :

Définissez Taille sur le nombre d’octets dans la structure INTERFACE. Cette valeur ne doit pas dépasser le nombre d’octets spécifié par QueryInterface ->Size.
Définissez version sur la version de l’interface retournée par le pilote miniport d’affichage. Le pilote miniport d’affichage doit correspondre le mieux à la version demandée par le pilote enfant dans QueryInterface->Version.
Définissez contexte pour pointer vers un contexte défini par le pilote miniport d’affichage pour l’interface. En règle générale, un pilote miniport d’affichage définit contexte sur le handle du bloc de contexte de l’adaptateur d’affichage identifié par MiniportDeviceContext.
Initialisez InterfaceReference et InterfaceDereference pour pointer vers les routines de référence et de déréférencement implémentées par le pilote miniport d’affichage pour cette interface.
Initialisez tous les membres supplémentaires spécifiques à l’interface pour pointer vers les routines appropriées de l’interface exposées.