D3DKMTEscape-Funktion (d3dkmthk.h)

Die D3DKMTEscape Funktion austauscht Informationen zwischen dem Benutzermodusanzeigetreiber (UMD) (oder Clienttreiber) und dem Kernelmodus-Miniporttreiber (KMD).

Syntax

NTSTATUS D3DKMTEscape(
  [in] const D3DKMT_ESCAPE *unnamedParam1
);

Parameter

[in] unnamedParam1

Zeigen Sie auf eine D3DKMT_ESCAPE Struktur, die die ausgetauschten Informationen beschreibt.

Rückgabewert

D3DKMTEscape gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Informationen wurden erfolgreich freigegeben.
STATUS_DEVICE_REMOVED	Der Grafikkarte wurde beendet, oder das Anzeigegerät wurde zurückgesetzt.
STATUS_INVALID_PARAMETER	Parameter wurden überprüft und ermittelt, dass sie falsch sind.
STATUS_NO_MEMORY	D3DKMTEscape- konnte aufgrund unzureichendem Arbeitsspeicher nicht abgeschlossen werden.
STATUS_PRIVILEGED_INSTRUCTION	D3DKMTEscape nicht privilegierte Anweisungen erkannt (d. h. Anweisungen, die über die Berechtigungen des aktuellen CPU-Prozesses hinausgehen).
STATUS_ILLEGAL_INSTRUCTION	D3DKMTEscape erkannte Anweisungen, die von grafikhardware nicht unterstützt werden können.

Diese Funktion kann auch andere NTSTATUS- Werte zurückgeben.

Bemerkungen

Der UMD- oder Clienttreiber ruft D3DKMTEscape- auf, um Daten direkt mit der KMD auszutauschen. Zu Testzwecken können D3DKMTEscape- aufgerufen werden, um den Videospeicher-Manager (VidMm) und den GPU-Scheduler (die Teil von Dxgkrnl.sys) sind, und das Verhalten des Timeout-Erkennungs- und Wiederherstellungsprozesses (TDR) des Betriebssystems zu steuern.

Hardwareanbieter können D3DKMTEscape in ihren Treibern als Erweiterungsmechanismus verwenden. Anbieter sollten jedoch die erforderlichen Erweiterungen an Microsoft melden, damit die Erweiterungen vom Betriebssystem nativ unterstützt werden können.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
Zielplattform-	Universal
Header-	d3dkmthk.h (einschließlich D3dkmthk.h)
Library	Gdi32.lib
DLL-	Gdi32.dll

Siehe auch

D3DKMT_ESCAPE