DXGKDDI_EXCHANGEPRESTARTINFO Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

Ermöglicht den Austausch sehr einfacher Daten zwischen Betriebssystem und Treiber, die möglicherweise vor dem Aufruf des DxgkDdiStartDevice-Geräts erforderlich sind und daher nicht über normale Caps 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

Zeiger auf eine DXGK_PRE_START_INFO-Struktur , die beide Felder für das Betriebssystem zum Übergeben von Informationen und Felder für den Treiber enthält, um Informationen zurückzugeben. Zunächst ist nur SupportPreserveBootDisplay definiert.

[out] SupportPreserveBootDisplay

Der Treiber und die Hardware unterstützen die Anforderungen, die es ermöglichen, dass der Startframepuffer während der gesamten Hardwareinitialisierung während der DxgkDdiStartDevice verwendet und angezeigt werden kann.

Rückgabewert

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

Hinweise

Dieser DDI wird nach DxgkDdiAddDevice und vor DxgkDdiStartDevice aufgerufen, sodass der Treiber keinen Zugriff auf seine eigenen Hardwareressourcen hat. Es kann jedoch das An den Treiber in DxgkDdiAddDevice übergebenePhysicalDeviceObject verwenden, um IoGetDeviceProperty aufzurufen. 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 nach Möglichkeit ausgelagert werden sollte.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dispmprt.h

Freigeben über