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) |