D3DKMT_ESCAPE Struktur (d3dkmthk.h)

Artikel
02/08/2025

Die D3DKMT_ESCAPE Struktur beschreibt Informationen, die zwischen einem Benutzermodusanzeigetreiber (UMD) (oder Clienttreiber) und dem Kernelmodus-Miniporttreiber (KMD) ausgetauscht werden.

Syntax

typedef struct _D3DKMT_ESCAPE {
  [in]     D3DKMT_HANDLE      hAdapter;
  [in]     D3DKMT_HANDLE      hDevice;
  [in]     D3DKMT_ESCAPETYPE  Type;
  [in]     D3DDDI_ESCAPEFLAGS Flags;
  [in/out] VOID               *pPrivateDriverData;
  [in]     UINT               PrivateDriverDataSize;
  [in]     D3DKMT_HANDLE      hContext;
} D3DKMT_ESCAPE;

Member

[in] hAdapter

Ein Handle für den Grafikkartenadapter, auf dem Informationen ausgetauscht werden.

[in] hDevice

Ein Handle für ein Anzeigegerät, das optional angegeben wird, wenn die zu tauschenden Informationen für ein bestimmtes Gerät spezifisch sind.

[in] Type

Ein D3DKMT_ESCAPETYPE Enumerationswert, der angibt, dass Informationen mit der KMD ausgetauscht werden sollen, oder um Kernelmoduskomponenten zu steuern. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	Das pPrivateDriverData- Mitglied wird auf die KMD ausgerichtet. Der Hardwareanbieter definiert das Format der Escapedaten.
D3DKMT_ESCAPE_VIDMM (1)	Nicht verwenden; nur zu Testzwecken. Der UMD/Client-Treiber steuert den Videospeicher-Manager (VidMm). Der Puffer, der pPrivateDriverData verweist, enthält eine D3DKMT_VIDMM_ESCAPE Struktur, die verschiedene Arten der Steuerung von VidMm-unterstützt.
D3DKMT_ESCAPE_TDRDBGCTRL (2)	Nicht verwenden; nur zu Testzwecken. Mit dem Escapevorgang kann der Benutzer das Verhalten des Timeout-Erkennungs- und Wiederherstellungsprozesses (Timeout Detection and Recovery, TDR) des Betriebssystems steuern. Diese Funktionalität ist standardmäßig deaktiviert. Um diese Funktionalität zu aktivieren, muss der Im HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers-Schlüssel gespeicherte TdrTestMode = TdrTestMode DWORD-Registrierungswert auf 1 festgelegt werden. Die PrivateDriverDataSize Member ist auf sizeof(int) festgelegt. Das pPrivateDriverData Member wird auf eine ganze Zahl mit einem Wert aus dem D3DKMT_TDRDBGCTRLTYPE Enumerationstyp festgelegt.
D3DKMT_ESCAPE_VIDSCH (3)	Nicht verwenden; nur zu Testzwecken. Der UMD-/Clienttreiber steuert den GPU-Scheduler (der Teil Dxgkrnl-ist). Der Puffer, der pPrivateDriverData verweist, enthält eine D3DKMT_VIDSCH_ESCAPE Struktur, die das Voraussetzen und Anhalten oder Fortsetzen des Schedulers unterstützt.
D3DKMT_ESCAPE_DEVICE (4)	Nicht verwenden; nur zu Testzwecken. Der UMD-/Clienttreiber steuert das Anzeigegerät. Der Puffer, der pPrivateDriverData- verweist, enthält eine D3DKMT_DEVICE_ESCAPE Struktur, die das Abrufen der quelle für Video präsentierenden Videos aus der primären Zuordnung unterstützt.
D3DKMT_ESCAPE_DMM (5)	Nicht verwenden; nur zu Testzwecken. Der UMD-/Clienttreiber steuert den Anzeigemodus-Manager. Der Puffer , auf den pPrivateDriverData verweist, enthält eine D3DKMT_DMM_ESCAPE Struktur.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	Nicht verwenden; nur zu Testzwecken. Der UMD-/Clienttreiber ruft einen Debugmomentaufnahmepuffer ab. Der Puffer, der pPrivateDriverData verweist, enthält eine D3DKMT_DEBUG_SNAPSHOT_ESCAPE Struktur.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Nicht verwenden; nur zu Testzwecken. Der UMD-/Clienttreiber legt den KMD-Updatestatus fest.
D3DKMT_ESCAPE_DRT_TEST (8)	Nicht verwenden; nur zu Testzwecken.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_BDD_PNP (12)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_WQHL_INFO(16)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_BRIGHTNESS(17)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_EDID_CACHE(18)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.
D3DKMT_ESCAPE_WIN32K_START(1024)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8 unterstützt.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Nicht verwenden; nur zu Testzwecken. Wird ab Windows 8.1 unterstützt.

[in] Flags

Eine D3DDDI_ESCAPEFLAGS Struktur, die in Bitfeldkennzeichnungen angibt, wie Informationen freigegeben werden. Der UMD-/Clienttreiber sollte das HardwareAccess- Bitfeld-Flag angeben, um anzugeben, dass die KMD auf Grafikhardware zugreifen muss, sodass das Betriebssystem die zweite Synchronisierungsebene in die KMD für den DxgkDdiEscape- Aufruf ausführen muss.

HardwareAccess- sollte beim Verwenden der Virtualisierung auf Null festgelegt werden. Weitere Informationen finden Sie unter GPU-Paravirtualisierung.

[in/out] pPrivateDriverData

Ein Zeiger auf einen Puffer, den der UMD- oder Clienttreiber zuweist, der eine bekannte Treiber-Escapestruktur enthält. Diese Struktur enthält Informationen, die der Treiber entweder mit dem KMD austauscht oder zum Steuern von Kernelmoduskomponenten verwendet. In der folgenden Tabelle wird der Inhalt des Puffers beschrieben, auf den pPrivateDriverData verweist, abhängig vom Wert Type.

Wert des Typs	Inhalt des pPrivateDriverData-Puffers
D3DKMT_ESCAPE_DRIVERPRIVATE	Treiberspezifisch. Der Puffer kann nur verwendet werden, wenn zwischen dem UMD-/Clienttreiber und dem KMD eine enge Kopplung vorhanden ist.
D3DKMT_ESCAPE_VIDMM	Nicht verwenden; nur zu Testzwecken. Eine D3DKMT_VIDMM_ESCAPE Struktur.
D3DKMT_ESCAPE_TDRDBGCTRL	Nicht verwenden; nur zu Testzwecken. Ein D3DKMT_TDRDBGCTRLTYPE Enumerationstyp.
D3DKMT_ESCAPE_VIDSCH	Nicht verwenden; nur zu Testzwecken. Eine D3DKMT_VIDSCH_ESCAPE Struktur.
D3DKMT_ESCAPE_DEVICE	Nicht verwenden; nur zu Testzwecken. Eine D3DKMT_DEVICE_ESCAPE Struktur.
D3DKMT_ESCAPE_DMM	Nicht verwenden; nur zu Testzwecken. Eine D3DKMT_DMM_ESCAPE Struktur.
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	Nicht verwenden; nur zu Testzwecken. Eine D3DKMT_DEBUG_SNAPSHOT_ESCAPE Struktur.

[in] PrivateDriverDataSize

Die Größe des Puffers in Bytes, auf den pPrivateDriverData verweist. Der UMD-/Clienttreiber muss die Größe des Puffers angeben, wenn der D3DKMTEscape--Funktion aufgerufen wird.

[in] hContext

Ein Handle zu einem Kontext, der optional angegeben wird, wenn die zu tauschenden Informationen für einen bestimmten Gerätekontext spezifisch sind. Wenn der UMD-/Clienttreiber hContext- auf einen Wert ungleich NULL festlegt, muss der Treiber auch hDevice- auf einen Wert ungleich NULL festgelegt haben, und hDevice- muss dem Gerät entsprechen, das den Kontext besitzt.