D3DKMTEscape-Funktion (d3dkmthk.h)
Die D3DKMTEscape-Funktion tauscht Informationen mit dem Display-Miniporttreiber aus.
Syntax
NTSTATUS D3DKMTEscape(
[in] const D3DKMT_ESCAPE *unnamedParam1
);
Parameter
[in] unnamedParam1
Ein Zeiger auf eine Struktur, die die ausgetauschten Informationen beschreibt.
Rückgabewert
D3DKMTEscape gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Informationen wurden erfolgreich freigegeben. |
| STATUS_DEVICE_REMOVED | Der Grafikkarte wurde beendet oder das Anzeigegerät zurückgesetzt. |
| STATUS_INVALID_PARAMETER | Parameter wurden überprüft und als falsch ermittelt. |
| STATUS_NO_MEMORY | D3DKMTEscape konnte aufgrund von unzureichendem Arbeitsspeicher nicht abgeschlossen werden. |
| STATUS_PRIVILEGED_INSTRUCTION | D3DKMTEscape erkannte nicht privilegierte Anweisungen (d. a. Anweisungen, die über die Berechtigungen des aktuellen CPU-Prozesses hinaus auf Arbeitsspeicher zugreifen). |
| STATUS_ILLEGAL_INSTRUCTION | D3DKMTEscape hat Anweisungen erkannt, die von Grafikhardware nicht unterstützt werden können. |
Diese Funktion kann auch andere NTSTATUS-Werte zurückgeben.
Hinweise
Der OpenGL ICD ruft D3DKMTEscape auf, um Daten direkt mit dem Display-Miniporttreiber auszutauschen. Zu Testzwecken kann der OpenGL ICD auch D3DKMTEscape aufrufen, um den Planer video memory manager and graphics processing unit (GPU) (die Teil von Dxgkrnl.syssind) und das Verhalten des TDR-Prozesses (Timeouterkennung und -wiederherstellung) des Betriebssystems zu steuern.
Hardwarehersteller können D3DKMTEscape in ihren OpenGL-ICDs 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Universell |
| Header | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |