DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Wird aufgerufen, nachdem eine neue Mehrebenenüberlagerungskonfiguration wirksam wurde, sodass der Treiber den Hardwarezustand optimieren kann. Optional für Windows Display Driver Model (WDDM) 2.0 oder höher Treiber, die Mehrebenenüberlagerungen unterstützen.

Syntax

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT DxgkddiPostmultiplaneoverlaypresent;

NTSTATUS DxgkddiPostmultiplaneoverlaypresent(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_POSTMULTIPLANEOVERLAYPRESENT pPostPresent
)
{...}

Parameter

hAdapter

Gibt den Adapter an, der die Überlagerungshardware enthält.

pPostPresent

Ein Zeiger auf eine DXGKARG_POSTMULTIPLANEOVERLAYPRESENT Struktur, die die neue Überlagerungskonfiguration beschreibt, die kürzlich zugesichert wurde.

Rückgabewert

DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT gibt die folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Wenn die Routine erfolgreich abgeschlossen wurde. Der Treiber sollte immer einen Erfolgscode zurückgeben. Fehler führen zu einer Fehlerüberprüfung.

Bemerkungen

Diese Funktion wird von passiver Ebene aufgerufen.

Diese Funktion wird nur aufgerufen, wenn der Treiber PostPresentNeeded von DXGKCB_NOTIFY_MPO_VSYNC_FLAGS Member der DXGKARGCB_NOTIFY_INTERRUPT_DATA-Struktur im VSYNC-Rückruf festlegt.

Der Treiber kann diese Funktion verwenden, um Spannungsstufen, Uhren, FIFO-Tiefen oder eine andere Optimierung zu senken, die Energie sparen kann.

Der Treiber sollte in diesem Aufruf keine erhebliche Zeit verbringen, da der Aufruf den Hauptthread des GPU-Planers blockiert und die Verzögerung zu vorhandenen Störungen führen könnte. Zeitintensive Aktionen sollten als separate Arbeitsaufgaben nach Treiber in die Warteschlange gestellt und im Hintergrund behandelt werden. In diesem Szenario sollten alle Konflikte zwischen dem in die Warteschlange eingereihten Element und Hardwareänderungen, die von zukünftigen Vor-/Post-Anrufen verlangt werden, vom Treiber verwaltet werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	d3dkmddi.h

Freigeben über