structure QUERY_INTERFACE (video.h)

Article
01/16/2025

La structure QUERY_INTERFACE décrit l’interface demandée.

Syntaxe

typedef struct _QUERY_INTERFACE {
  const GUID *InterfaceType;
  USHORT     Size;
  USHORT     Version;
  PINTERFACE Interface;
  PVOID      InterfaceSpecificData;
  ULONG      DeviceUid;
} QUERY_INTERFACE, *PQUERY_INTERFACE;

Membres

InterfaceType

Pointeur vers un GUID qui identifie l’interface demandée. Si le pilote de miniportage en mode noyau (KMD) (ou pilote de miniport vidéo hérité) ne prend pas en charge leInterfaceType spécifié, il doit échouer immédiatement l’appel et retourner immédiatement.

Le parent génère ce GUID avec uuidgen.exe. Pour plus d’informations, consultez Définition et exportation de nouveaux GUID.

Size

Spécifie la taille en octets de l’interface structure à laquelle interface points. Le pilote ne doit pas retourner une structure interface supérieure à Taille octets.

Version

Spécifie la version de l’interface demandée.

Si un parent prend en charge plusieurs versions d’une interface, son pilote doit retourner la version spécifiée ou, si possible, la version la plus proche prise en charge sans dépasser la version demandée. L’appelant est chargé d’examiner la version retournée et de déterminer ce qu’il faut faire en fonction de cette valeur.

Interface

Pointeur vers une interface structure dans laquelle le pilote retourne les informations d’interface demandées. L’appelant est chargé d’allouer cette structure avant d’appeler DxgkddiQueryInterface (ou HwVidQueryInterface).

InterfaceSpecificData

Spécifie des informations supplémentaires sur l’interface demandée. En règle générale, ce membre a la valeur NULL et les membres InterfaceType et version sont suffisants pour que le parent identifie l’interface demandée.

DeviceUid

Entier positif qui identifie l’appareil pour lequel l’interface est interrogée. Si DeviceUid est égal à DISPLAY_ADAPTER_HW_ID (défini dans Video.h), l’appareil est l’adaptateur d’affichage lui-même. Sinon, DeviceUid est l’identificateur d’un appareil enfant de l’adaptateur d’affichage. Les identificateurs d’appareil enfant ont été précédemment affectés par la fonction DxgkDdiQueryChildRelations. Disponible à partir de Windows 8.1 (WDDM 1.3).

Remarques

Le paramètre QueryInterface du rappel DxgkddiQueryInterface (ou pilote de miniport vidéo hérité's HwVidQueryInterface function) est un pointeur vers une structure QUERY_INTERFACE.

Exigences

Exigence	Valeur
d’en-tête	video.h (include Video.h)

Voir aussi

DxgkddiQueryInterface

HwVidQueryInterface

Partager via