D3DKMT_ESCAPE-Struktur (d3dkmthk.h)

Artikel
02/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 die Grafikkarte, über die Informationen ausgetauscht werden.

[in] hDevice

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

[in] Type

Ein Wert vom Typ D3DKMT_ESCAPETYPE, der entweder den Austausch von Informationen mit dem Anzeigeminiporttreiber oder die Steuerung von Kernelmoduskomponenten angibt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	Bedeutung
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	Das pPrivateDriverData-Element ist auf den Anzeigeminiporttreiber ausgerichtet. Der Hardwarehersteller definiert das Format der Escapedaten.
D3DKMT_ESCAPE_VIDMM (1)	Nicht verwenden. Nur zu Testzwecken. Der OpenGL ICD steuert den Videospeicher-Manager (der Teil von Dxgkrnl.sys ist). 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 Timeouterkennungs- 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 DWORD-Registrierungswert TdrTestMode = TdrTestMode, der im HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers-Schlüssel gespeichert ist, auf 1 festgelegt werden. Das PrivateDriverDataSize-Element ist auf sizeof(int) festgelegt. Das pPrivateDriverData-Element wird auf eine ganze Zahl mit einem Wert aus dem D3DKMT_TDRDBGCTRLTYPE Enumerationstyp festgelegt.
D3DKMT_ESCAPE_VIDSCH (3)	Nicht verwenden. Nur zu Testzwecken. Der OpenGL ICD steuert den GPU-Scheduler (Grafikverarbeitungseinheit), der Teil von Dxgkrnl.sys ist. Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_VIDSCH_ESCAPE-Struktur , die die Vorzeitige Entfernungssteuerung und das Anhalten oder Fortsetzen des Schedulers unterstützt.
D3DKMT_ESCAPE_DEVICE (4)	Nicht verwenden. Nur zu Testzwecken. Der OpenGL ICD steuert das Anzeigegerät. Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_DEVICE_ESCAPE-Struktur , die das Abrufen der vorhandenen Videoquelle aus der primären Zuordnung unterstützt.
D3DKMT_ESCAPE_DMM (5)	Nicht verwenden. Nur zu Testzwecken. Der 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. Die OpenGL ICD ruft einen Debug-Momentaufnahme-Puffer ab. Der Puffer, auf den pPrivateDriverData verweist, enthält eine D3DKMT_DEBUG_SNAPSHOT_ESCAPE-Struktur .
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Nicht verwenden. Nur zu Testzwecken. Das OpenGL ICD legt das Update des Anzeigeminiporttreibers status fest.
D3DKMT_ESCAPE_DRT_TEST (8)	Nicht verwenden. Nur zu Testzwecken.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
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 Bitfeldflags angibt, wie Informationen freigegeben werden sollen. Der OpenGL ICD sollte das HardwareAccess-Bitfeldflag angeben, um anzugeben, dass der Display-Miniporttreiber so auf Grafikhardware zugreifen muss, dass das Betriebssystem die zweite Synchronisierungsebene im Anzeigeminiporttreiber für den DxgkDdiEscape-Aufruf durchführen muss.

[in/out] pPrivateDriverData

Ein Zeiger auf einen Puffer, den der OpenGL ICD ordnet, der Informationen enthält, die der 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 je nach Wert von Type verweist.

Wert des Typmembers	Inhalt des pPrivateDriverData-Puffers
D3DKMT_ESCAPE_DRIVERPRIVATE	Treiberspezifisch. Der Puffer kann nur verwendet werden, wenn eine enge Kopplung zwischen dem OpenGL ICD und dem Display-Miniporttreiber besteht.
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 OpenGL ICD muss die Größe des Puffers angeben, wenn die D3DKMTEscape-Funktion aufgerufen wird.

[in] hContext

Ein Handle für einen Kontext, der optional angegeben wird, wenn die auszutauschenden Informationen für einen bestimmten Gerätekontext spezifisch sind. Wenn der OpenGL ICD hContext auf einen Wert ohne NULL festlegt, muss der ICD auch hDevice auf einen Wert ohne NULL festgelegt haben, und hDevice muss dem Gerät entsprechen, das den Kontext besitzt.

Hinweise

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