DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 Rückruffunktion (d3dkmddi.h)

  • Artikel

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 wird aufgerufen, um die angezeigte Overlaykonfiguration zu ändern.

Syntax

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3;

NTSTATUS DxgkddiSetvidpnsourceaddresswithmultiplaneoverlay3(
  IN_CONST_HANDLE hAdapter,
  IN_OUT_PDXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 pSetVidPnSourceAddressWithMultiPlaneOverlay
)
{...}

Parameter

hAdapter

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

pSetVidPnSourceAddressWithMultiPlaneOverlay

Ein Zeiger auf eine DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 Struktur, die die darzustellenden Oberflächen und Anzeigeoptionen beschreibt.

Rückgabewert

DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 gibt die folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Routine wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER Im [Hardware-Flip-Warteschlangenmodell]/windows-hardware/drivers/display/hardware-flip-queue konnte der Treiber keine Flip-Anforderung verarbeiten.
STATUS_RETRY Wird aus Gründen zurückgegeben, z. B. konnte der Treiber eine Anforderung aufgrund ausstehender Flips nicht an die Hardware in die Warteschlange stellen, oder der Treiber muss am PASSIVE_LEVEL aufgerufen werden. Wenn der Treiber bei PASSIVE_LEVEL aufgerufen werden muss, sollte er auch die DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS festlegen. PräPresentNeeded-Flag .

Hinweise

Diese Funktion wird in der Regel auf Interruptebene aufgerufen, aber wenn der Treiber eine Hardwarekonfiguration ausführen muss, die nur bei PASSIVE_LEVEL ausgeführt werden kann, kann der Treiber anfordern, dass diese Funktion bei PASSIVE_LEVEL abgerufen wird, indem er STATUS_RETRY zurückgibt und die DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGS festlegt. PräPresentNeeded-Flag .

Selbst wenn er bei PASSIVE_LEVEL aufgerufen wird, sollte der Treiber vermeiden, einen erheblichen Zeitaufwand für diesen Aufruf zu verbringen, 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 befindlichen 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

Weitere Informationen

DXGKARG_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3