DXGKDDI_EXCHANGEPRESTARTINFO Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Ermöglicht es, sehr einfache Daten zwischen dem Betriebssystem und dem Treiber auszutauschen, die vor dem Aufrufen des DxgkDdiStartDevice-Geräts erforderlich sein können und daher nicht über normale Kaps oder Adapterinfo-DDIs abgefragt werden können.

Syntax

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

Parameter

[in] hAdapter

Identifiziert den Adapter.

[in] pPreStartInfo

Zeigen Sie auf eine DXGK_PRE_START_INFO-Struktur, die beide Felder für das Betriebssystem enthält, um Informationen und Felder für den Treiber zurückzugeben. Zunächst wird nur SupportPreserveBootDisplay- definiert.

[out] SupportPreserveBootDisplay

Der Treiber und die Hardware unterstützen die Anforderungen, mit denen der Startframepuffer während der Hardwareinitialisierung verwendet und angezeigt werden kann, die während DxgkDdiStartDeviceausgeführt wird.

Rückgabewert

Wenn diese Routine erfolgreich ist und die angeforderte Änderung zurückgibt, wird STATUS_SUCCESS zurückgegeben.

Bemerkungen

Dieser DDI wird nach DxgkDdiAddDevice- und vor DxgkDdiStartDevice aufgerufen, sodass der Treiber keinen Zugriff auf seine eigenen Hardwareressourcen hat. Es kann jedoch das PhysicalDeviceObject an den Treiber in DxgkDdiAddDevice übergeben werden, um IoGetDevicePropertyaufzurufen. Beispielsweise kann die Hardware-ID gefunden werden, um zu entscheiden, was in den Ausgabefeldern der DXGK_PRE_START_INFO-Struktur zurückgegeben werden soll.

Diese Funktion wird immer auf PASSIVEr Ebene aufgerufen, sodass der unterstützende Code möglichst seitenfähig gemacht werden sollte.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	dispmprt.h

Freigeben über