DXGKDDI_QUERY_INTERFACE Rückruffunktion (dispmprt.h)

Artikel
05/23/2024

Die DxgkDdiQueryInterface-Funktion gibt eine Funktionsschnittstelle zurück, die vom Anzeigeminiporttreiber implementiert wird.

Syntax

DXGKDDI_QUERY_INTERFACE DxgkddiQueryInterface;

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

Parameter

[in] MiniportDeviceContext

Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers hat dieses Handle zuvor für Dxgkrnl bereitgestellt.

[in] QueryInterface

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

Rückgabewert

DxgkDdiQueryInterface gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird ein entsprechender NTSTATUS-Code zurückgegeben. Wenn ein Anzeigeminiporttreiber die angeforderte Schnittstelle nicht unterstützt, muss er STATUS_NOT_SUPPORTED zurückgeben. Durch zurückgeben STATUS_NOT_SUPPORTED informiert der Anzeigeminiporttreiber das Betriebssystem, die Abfrage an den nächsten Treiber weiterzureichen.

Hinweise

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

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

Legen Sie Size auf die Anzahl von Bytes in der INTERFACE-Struktur fest. Dieser Wert darf die Anzahl von Bytes, die von QueryInterface-Size> angegeben wird, nicht überschreiten.
Legen Sie Version auf die Version der Schnittstelle fest, die vom Anzeigeminiporttreiber zurückgegeben wird. Der Anzeigeminiporttreiber sollte am besten mit der version übereinstimmen, die vom untergeordneten Treiber in QueryInterface-Version> angefordert wurde.
Legen Sie Context so fest, dass er auf einen vom Miniporttreiber definierten Kontext für die Schnittstelle verweist. In der Regel legt ein Anzeigeminiporttreiber Kontext auf das Handle für den Kontextblock der Anzeigekarte fest, der von MiniportDeviceContext identifiziert wird.
Initialisieren Sie InterfaceReference und InterfaceDereference , um auf die Referenz- und Dereferenceroutinen des Anzeigeminiporttreibers zu verweisen, die für diese Schnittstelle implementiert sind.
Initialisieren Sie alle zusätzlichen schnittstellenspezifischen Member, um auf die entsprechenden Routinen der verfügbar gemachten Schnittstelle zu verweisen.