QUERY_INTERFACE structure (video.h)

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 miniport ne prend pas en charge l’InterfaceType spécifié, il doit échouer 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 la structure INTERFACE vers laquelle l’interface pointe. Le pilote miniport ne doit pas retourner une structure INTERFACE supérieure à size 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 prise en charge la plus proche sans dépasser la version demandée. Il incombe au pilote d’interrogation d’examiner la version retournée et de déterminer ce qu’il faut faire en fonction de cette valeur.

Interface

Pointeur vers une structure INTERFACE dans laquelle le pilote miniport retourne les informations d’interface demandées. Le pilote d’interrogation est chargé d’allouer cette structure avant d’appeler HwVidQueryInterface.

InterfaceSpecificData

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

DeviceUid

Remarques

Le paramètre QueryInterface de la fonction HwVidQueryInterface du pilote de miniport vidéo est un pointeur vers une structure QUERY_INTERFACE.

Configuration requise

Voir aussi

HwVidQueryInterface