DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP Rückruffunktion (dispmprt.h)

Artikel
08/07/2023

Wird von einem Windows Display Driver Model (WDDM) 1.2 oder höher-Anzeigeminiporttreiber aufgerufen, um die Anzeigeinformationen vom aktuellen POST-Anzeigegerät (Power-On Self-Test) oder dem zuvor ausgeführten WDDM-Treiber abzurufen.

Der Treiber muss diese Anzeigeinformationen verwenden, um die anfängliche Änderungsanforderung für den Modus zu optimieren, nachdem das Anzeigegerät gestartet wurde.

Syntax

DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP DxgkcbAcquirePostDisplayOwnership;

NTSTATUS DxgkcbAcquirePostDisplayOwnership(
  [in]  HANDLE DeviceHandle,
  [out] PDXGK_DISPLAY_INFORMATION DisplayInfo
)
{...}

Parameter

[in] DeviceHandle

Ein Handle, das eine Grafikkarte darstellt. Der Anzeige-Miniporttreiber hat dieses Handle zuvor im DeviceHandle-Member der DXGKRNL_INTERFACE-Struktur abgerufen, die an DxgkDdiStartDevice übergeben wurde.

[out] DisplayInfo

Ein Zeiger auf eine DXGK_DISPLAY_INFORMATION Struktur, die vom Anzeigeminiporttreiber zugeordnet wird. Wenn DxgkCbAcquirePostDisplayOwnership STATUS_SUCCESS zurückgibt, enthält diese Struktur Anzeigeinformationen für das aktuelle Anzeigegerät, das für POST-Vorgänge verwendet wird.

Rückgabewert

DxgkCbAcquirePostDisplayOwnership gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in Ntstatus.h definierten Fehlercodes zurückgegeben.

Hinweise

Zulässige Farbformate

Das DisplayInfo->ColorFormat-Element muss eine bitweise OR-Kombination der folgenden beiden Formate enthalten:

D3DDDIFMT_X8R8G8B8
D3DDDIFMT_A8R8G8B8

Wenn das Betriebssystem das D3DDDIFMT_R8G8B8-Format zurückgibt, sollte es vom Anzeigeminiporttreiber ignoriert werden.

Initialisierung des vorhandenen Videoziels

Es ist möglich, dass das DisplayInfo->TargetId-Element nicht initialisiert wird. In diesem Fall ist der Bezeichner des vorliegenden Videoziels D3DDDI_ID_UNINITIALIZED. In der Regel tritt dies nach einem Systemstart auf.

Ebenso ist es möglich, dass der DisplayInfo-AcpiId-Member> nicht initialisiert wird. In diesem Fall weist der ACPI-Bezeichner AcpiId den Wert 0 (null) auf.

Im Falle eines Treiber-zu-Treiber-Upgrades hat der vorherige Treiber den Zielbezeichner und den ACPI-Bezeichner angegeben.

Implementierungsrichtlinien

Ab WDDM 1.2 muss der Display-Miniporttreiber diese Richtlinien befolgen, wenn er DxgkCbAcquirePostDisplayOwnership aufruft:

Der Einstiegspunkt für die DxgkCbAcquirePostDisplayOwnership-Funktion ist Teil der DXGKRNL_INTERFACE-Struktur . Diese Struktur wird über den DxgkInterface-Parameter an den Treiber zurückgegeben, wenn die DxgkDdiStartDevice-Funktion des Treibers aufgerufen wird.
Es ist optional, dass der Anzeigeminiporttreiber DxgkCbAcquirePostDisplayOwnership aufruft. Das Betriebssystem kann jedoch weiterhin die DxgkDdiStopDeviceAndReleasePostDisplayOwnership-Funktion des Gerätetreibers aufrufen, wenn der Treiber zuvor nicht DxgkCbAcquirePostDisplayOwnership aufgerufen hat.
Der Display-Miniporttreiber kann DxgkCbAcquirePostDisplayOwnership aufrufen, wenn das Gerät als Reaktion auf ein PnP-Ereignis (Plug & Play) gestartet wird. In diesem Fall muss der Treiber DxgkCbAcquirePostDisplayOwnership im Kontext des Aufrufs der DxgkDdiStartDevice-Funktion aufrufen.
Der Display-Miniporttreiber kann DxgkCbAcquirePostDisplayOwnership aufrufen, wenn das Gerät nach einem Ruhezustand einen PowerDeviceD0-Energiezustand fortgibt. In diesem Fall muss der Treiber DxgkCbAcquirePostDisplayOwnership im Kontext des Aufrufs der DxgkDdiSetPowerState-Funktion aufrufen.
Der Anzeige-Miniporttreiber darf die DxgkCbAcquirePostDisplayOwnership-Funktion nur aufrufen, wenn der Treiber unter Windows 8 oder einer höheren Version des Windows-Betriebssystems ausgeführt wird.
Hinweis Der Display-Miniporttreiber kann RtlGetVersion aufrufen, um die Version des Betriebssystems zu bestimmen.
DxgkCbAcquirePostDisplayOwnership gibt möglicherweise eine DXGK_DISPLAY_INFORMATION-Struktur zurück, bei der das Width-Element auf 0 festgelegt ist. Dies gibt an, dass entweder das aktuelle Anzeigegerät nicht für POST-Vorgänge geeignet ist oder das Betriebssystem nicht über die aktuellen Anzeigeinformationen für das aktuelle POST-Gerät verfügt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	dispmprt.h (include Dispmprt.h)
IRQL	<= APC_LEVEL