QUERY_INTERFACE-Struktur (video.h)

  • Artikel

Die QUERY_INTERFACE-Struktur beschreibt die angeforderte Schnittstelle.

Syntax

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

Member

InterfaceType

Zeiger auf eine GUID, die die angeforderte Schnittstelle identifiziert. Wenn der Miniporttreiber den angegebenen InterfaceType nicht unterstützt, sollte der Aufruf fehlschlagen und sofort zurückgegeben werden.

Das übergeordnete Element generiert diese GUID mit uuidgen.exe. Weitere Informationen finden Sie unter Definieren und Exportieren neuer GUIDs .

Size

Gibt die Größe der INTERFACE-Struktur in Byte an, auf die Interface verweist. Der Miniporttreiber darf keine INTERFACE-Struktur zurückgeben, die größer als Bytes ist .

Version

Gibt die Version der angeforderten Schnittstelle an.

Wenn ein übergeordnetes Element mehr als eine Version einer Schnittstelle unterstützt, sollte sein Treiber die angegebene Version oder, falls möglich, die nächstgelegene unterstützte Version zurückgeben, ohne die angeforderte Version zu überschreiten. Es liegt in der Verantwortung des abfragenden Treibers, die zurückgegebene Version zu untersuchen und basierend auf diesem Wert zu bestimmen, was zu tun ist.

Interface

Zeiger auf eine INTERFACE-Struktur , in der der Miniporttreiber die angeforderten Schnittstelleninformationen zurückgibt. Der Abfragetreiber ist für die Zuweisung dieser Struktur vor dem Aufruf von HwVidQueryInterface verantwortlich.

InterfaceSpecificData

Gibt zusätzliche Informationen zur angeforderten Schnittstelle an. In der Regel ist dieser Member NULL, und die Member InterfaceType und Version reichen aus, damit das übergeordnete Element die angeforderte Schnittstelle identifiziert.

DeviceUid

Hinweise

Der QueryInterface-Parameter der HwVidQueryInterface-Funktion des Videominiporttreibers ist ein Zeiger auf eine QUERY_INTERFACE-Struktur.

Anforderungen

Anforderung Wert
Header video.h (Video.h einschließen)

Weitere Informationen

HwVidQueryInterface