Freigeben über


QUERY_INTERFACE Struktur (video.h)

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;

Angehörige

InterfaceType

Zeiger auf eine GUID, die die angeforderte Schnittstelle identifiziert. Wenn der Kernelmodus-Miniporttreiber (KMD) (oder Legacy-Video-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 in Byte der INTERFACE- Struktur an, auf die Interface Punkte verweist. Der Treiber darf keine INTERFACE- Struktur zurückgeben, die größer als Größe Bytes ist.

Version

Gibt die Angeforderte Version der Schnittstelle an.

Wenn ein übergeordnetes Element mehr als eine Version einer Schnittstelle unterstützt, sollte der Treiber die angegebene Version zurückgeben oder, falls möglich, die am nächsten unterstützte Version, ohne die angeforderte Version zu überschreiten. Der Aufrufer ist dafür verantwortlich, die zurückgegebene Version zu untersuchen und zu bestimmen, was basierend auf diesem Wert zu tun ist.

Interface

Zeiger auf eine INTERFACE Struktur, in der der Treiber die angeforderten Schnittstelleninformationen zurückgibt. Der Aufrufer ist für die Zuordnung dieser Struktur verantwortlich, bevor DxgkddiQueryInterface- aufgerufen wird (oder HwVidQueryInterface).

InterfaceSpecificData

Gibt zusätzliche Informationen zur angeforderten Schnittstelle an. In der Regel ist dieses Element NULL, und die InterfaceType- und Version Member reichen für das übergeordnete Element aus, um die angeforderte Schnittstelle zu identifizieren.

DeviceUid

Eine positive ganze Zahl, die das Gerät identifiziert, für das die Schnittstelle abgefragt wird. Wenn DeviceUid- gleich DISPLAY_ADAPTER_HW_ID ist (definiert in Video.h), ist das Gerät der Anzeigeadapter selbst. Andernfalls ist DeviceUid der Bezeichner eines untergeordneten Geräts des Anzeigeadapters. Untergeordnete Gerätebezeichner wurden zuvor von der funktion DxgkDdiQueryChildRelations zugewiesen. Verfügbar ab Windows 8.1 (WDDM 1.3).

Bemerkungen

Der parameter QueryInterface parameter der DxgkddiQueryInterface callback (oder legacy video miniport driver's HwVidQueryInterface function) ist ein Zeiger auf eine QUERY_INTERFACE Struktur.

Anforderungen

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

Siehe auch

DxgkddiQueryInterface-

HwVidQueryInterface