DXGKDDI_QUERY_INTERFACE Rückruffunktion (dispmprt.h)

2025-02-06

Die DxgkDdiQueryInterface--Funktion gibt eine funktionale Schnittstelle zurück, die vom Display miniport-Treiber implementiert wird.

Syntax

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

NTSTATUS DxgkddiQueryInterface(
  [in] IN_CONST_PVOID MiniportDeviceContext,
  [in] IN_PQUERY_INTERFACE QueryInterface
)
{...}

Parameter

[in] MiniportDeviceContext

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Miniporttreibers dieses Handle zuvor für Dxgkrnl-bereitgestellt.

[in] QueryInterface

Ein Zeiger auf eine QUERY_INTERFACE Struktur, in der der Miniporttreiber Informationen zur unterstützten Schnittstelle zurückgeben soll.

Rückgabewert

DxgkDdiQueryInterface- gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben. Wenn ein Miniporttreiber die angeforderte Schnittstelle nicht unterstützt, muss er STATUS_NOT_SUPPORTED zurückgeben. Durch zurückgeben STATUS_NOT_SUPPORTED informiert der Display-Miniporttreiber das Betriebssystem, die Abfrage an den nächsten Treiber weiterzugibt.

Bemerkungen

DxgkDdiQueryInterface macht einen Kommunikationsmechanismus zwischen dem Display-Miniporttreiber und dem Treiber eines untergeordneten Geräts (z. B. einem Videoaufnahmegerät) verfügbar. Ein Display-Miniporttreiber, der einen solchen Mechanismus verfügbar macht, sollte diese Funktion implementieren.

DxgkDdiQueryInterface- sollte die Elemente der INTERFACE Struktur ausfüllen, die QueryInterface->Interface wie folgt verweist:

Legen Sie Größe auf die Anzahl der Bytes in der INTERFACE-Struktur fest. Dieser Wert darf die Anzahl der by QueryInterface->Sizeangegebenen Bytes nicht überschreiten.
Legen Sie Version auf die Version der Schnittstelle fest, die vom Display miniport-Treiber zurückgegeben wird. Der Miniporttreiber sollte am besten mit der vom untergeordneten Treiber in QueryInterface->Versionangeforderten Version übereinstimmen.
Legen Sie Kontext- so fest, dass sie auf einen vom Display miniporttreiber definierten Kontext für die Schnittstelle zeigt. In der Regel würde ein Anzeigeminiporttreiber Context- auf den Handle auf den Kontextblock des Displayadapters festlegen, der durch MiniportDeviceContext-identifiziert wird.
Initialisieren Sie InterfaceReference und InterfaceDereference-, um auf die referenz- und ableitungsroutinierte Miniport-Routinen für diese Schnittstelle zu verweisen.
Initialisieren Sie alle zusätzlichen schnittstellenspezifischen Member, um auf die entsprechenden Routinen der verfügbar gemachten Schnittstelle zu verweisen.