DXGKDDI_SETVIDPNSOURCEADDRESSWITHMULTIPLANEOVERLAY3 Rückruffunktion (d3dkmddi.h)
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 anzuzeigenden 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 Queue Model]/windows-hardware/drivers/display/hardware-flip-queue konnte der Treiber keine Flip-Anforderung verarbeiten. |
| STATUS_RETRY | Aus Gründen wie dem Treiber konnte keine Anforderung an die Hardware - aufgrund ausstehender Flips in die Warteschlange gestellt werden, oder der Treiber muss an der PASSIVE_LEVEL aufgerufen werden. Wenn der Treiber bei PASSIVE_LEVEL aufgerufen werden muss, sollte er auch die DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGSfestlegen.PrePresentNeededed Flag. |
Bemerkungen
Diese Funktion wird in der Regel auf Unterbrechungsebene aufgerufen, aber wenn der Treiber Hardwarekonfigurationen ausführen muss, die nur bei PASSIVE_LEVEL ausgeführt werden können, kann der Treiber anfordern, dass diese Funktion bei PASSIVE_LEVEL zurückgerufen wird, indem STATUS_RETRY zurückgegeben und die DXGK_SETVIDPNSOURCEADDRESS_OUTPUT_FLAGSfestgelegt wird.PrePresentNeededed Flag.
Selbst wenn er bei PASSIVE_LEVEL aufgerufen wird, sollte der Treiber eine erhebliche Zeit in diesem Aufruf vermeiden, 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 |