D3DKMT_ESCAPE Struktur (d3dkmthk.h)

Artikel
10/23/2024

Die D3DKMT_ESCAPE Struktur beschreibt Informationen, die mit dem Display Miniporttreiber 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 Wert vom Typ D3DKMT_ESCAPETYPE, der entweder angibt, Informationen mit dem Anzeigeminiporttreiber auszutauschen oder Kernelmoduskomponenten zu steuern. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	Der pPrivateDriverData-Member wird auf den Miniporttreiber für den Display-Miniport ausgerichtet. Der Hardwareanbieter definiert das Format der Escapedaten.
D3DKMT_ESCAPE_VIDMM (1)	Nicht verwenden. Nur zu Testzwecken. Die OpenGL ICD steuert den Videospeicher-Manager (der Teil von Dxgkrnl.sysist). Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_VIDMM_ESCAPE Struktur, die verschiedene Arten der Steuerung des Videospeicher-Managers 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. Der Member "PrivateDriverDataSize" ist auf "sizeof(int)" festgelegt. Der 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. Die OpenGL ICD steuert den Gpu-Planer (Grafikverarbeitungseinheit) (der Teil von Dxgkrnl.sysist). Der Puffer, auf den 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. Die OpenGL ICD steuert das Anzeigegerät. Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_DEVICE_ESCAPE Struktur, die das Abrufen der video present-Quelle aus der primären Zuordnung unterstützt.
D3DKMT_ESCAPE_DMM (5)	Nicht verwenden. Nur zu Testzwecken. Die OpenGL ICD 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. Das OpenGL ICD ruft einen Debugmomentaufnahmepuffer ab. Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_DEBUG_SNAPSHOT_ESCAPE Struktur.
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Nicht verwenden. Nur zu Testzwecken. Die OpenGL ICD legt den Aktualisierungsstatus des Miniporttreibers 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. Das OpenGL ICD sollte das HardwareAccess- Bitfeldflagge angeben, um anzugeben, dass der Miniporttreiber auf Grafikhardware zugreifen muss, sodass das Betriebssystem die zweite Synchronisierungsebene im Display-Miniporttreiber für den DxgkDdiEscape Aufruf ausführen muss.

[in/out] pPrivateDriverData

Ein Zeiger auf einen Puffer, den die OpenGL ICD zuweist, die Informationen enthält, die die OpenGL ICD entweder mit dem Anzeigeminiporttreiber 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 Typelements	Inhalt des pPrivateDriverData-Puffers
D3DKMT_ESCAPE_DRIVERPRIVATE	Treiberspezifisch. Der Puffer kann nur verwendet werden, wenn zwischen dem OpenGL ICD und dem Display-Miniporttreiber 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. Die OpenGL ICD muss die Größe des Puffers angeben, wenn sie die D3DKMTEscape--Funktion aufruft.

[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 das OpenGL ICD hContext- auf einen Wert ungleich NULL festlegt, muss die ICD auch hDevice- auf einen Wert ungleich NULL festgelegt haben, und hDevice- muss dem Gerät entsprechen, das den Kontext besitzt.

Hinweise

Zu Testzwecken kann das OpenGL ICD einen Zeiger auf eine D3DKMT_ESCAPE Struktur in einem Aufruf des D3DKMTEscape-- übergeben, um den Videospeicher-Manager und den GPU-Scheduler (die Teil von Dxgkrnl.syssind) und das Verhalten des TDR-Prozesses des Betriebssystems zu steuern.