PFND3DKMT_OUTPUTDUPLPRESENT Rückruffunktion (d3dkmthk.h)

  • Artikel

Übermittelt einen vorhandenen Befehl aus der Desktopduplizierungs-API-Swapchain des Desktopfenster-Managers (DWM) an das Microsoft DirectX-Grafikkernsystem (Dxgkrnl.sys).

Syntax

PFND3DKMT_OUTPUTDUPLPRESENT Pfnd3dkmtOutputduplpresent;

NTSTATUS Pfnd3dkmtOutputduplpresent(
  [in] const D3DKMT_OUTPUTDUPLPRESENT *unnamedParam1
)
{...}

Parameter

[in] unnamedParam1

Pdata

Ein Zeiger auf eine D3DKMT_OUTPUTDUPLPRESENT Struktur, die Parameter für den aktuellen Vorgang beschreibt.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Der vorliegende Vorgang wurde erfolgreich ausgeführt.
STATUS_DEVICE_REMOVED Die Grafikkarte wurde beendet, oder der Anzeigekontext wurde zurückgesetzt.
STATUS_INVALID_PARAMETER Die Parameter wurden überprüft und als falsch ermittelt.
STATUS_NO_MEMORY D3DKMTOutputDuplPresent konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden.
STATUS_GRAPHICS_ALLOCATION_INVALID Der primäre Oberflächenziehpunkt wurde aufgrund einer Änderung des Anzeigemodus ungültig. Wenn der installierbare OpenGL-Clienttreiber (ICD) diesen Fehlercode empfängt, sollte er das primäre Handle erneut öffnen oder neu erstellen, alle Verweise im Befehlspuffer durch das alte Handle durch das neue Handle ersetzen und den Puffer dann erneut übermitteln.
STATUS_GRAPHICS_GPU_EXCEPTION_ON_DEVICE Fehler im Rendergerätekontext, den der hContext-Member von D3DKMT_OUTPUTDUPLPRESENT angibt.
Hinweis: Dieser Fehlercode gibt nicht an, dass ein Timeouterkennungs- und Wiederherstellungsprozess (Timeout Detection and Recovery, TDR) initiiert wurde oder dass die GPU nicht mehr reagiert.
Beispielsweise versetzt das DirectX-Grafikkernsubsystem ein Gerät in einen Fehlerzustand, wenn der Anzeige-Miniporttreiber angibt, dass ein DMA-Puffer, der von diesem Gerät übermittelt wurde, einen Fehler verursacht hat, oder wenn der Videospeicher-Manager nicht alle Zuordnungen ausgelagert hat, die für einen DMA-Puffer erforderlich sind, auch nach dem Aufteilen des DMA-Puffers. Nachdem sich ein Gerät in einem Fehlerzustand befindet, kann es keine weiteren Vorgänge mehr ausführen und muss zerstört und neu erstellt werden. Der ICD kann die Funktion D3DKMTGetDeviceState aufrufen, um eine genauere Ursache für den Fehler zu ermitteln.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Universell
Header d3dkmthk.h (include D3dkmthk.h)

Weitere Informationen

D3DKMTGetDeviceState

D3DKMT_OUTPUTDUPLPRESENT