DXGKDDI_POSTMULTIPLANEOVERLAYPRESENT Rückruffunktion (d3dkmddi.h)

  • Artikel

Wird aufgerufen, nachdem eine neue Mehrebenen-Overlaykonfiguration wirksam wurde, sodass der Treiber den Hardwarezustand optimieren kann. Optional für Windows Display Driver Model (WDDM) 2.0 oder höher, 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 committet 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.

Hinweise

Diese Funktion wird von der PASSIVE-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 Spannungspegel, Uhren, FIFO-Tiefen oder andere Optimierungen zu senken, die Strom sparen können.

Der Treiber sollte nicht viel Zeit für diesen Aufruf aufwenden, da der Aufruf den Standard GPU-Planerthread blockiert und die Verzögerung zu vorhandenen Störungen führen kann. Zeitintensive Aktionen sollten vom Treiber als separate Arbeitselemente in die Warteschlange eingereiht und im Hintergrund behandelt werden. In diesem Szenario sollten alle Konflikte zwischen dem in der Warteschlange eingereihten Element und Hardwareänderungen, die von zukünftigen Pre/Post-Aufrufen verlangt werden, vom Treiber verwaltet werden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3dkmddi.h