D3DKMT_ESCAPE-Struktur (d3dkmthk.h)

Artikel
05/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;
  void               D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [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. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Nicht verwenden. Nur zu Testzwecken. Unterstützt ab Windows 8.1.

[in] Flags

Eine D3DDDI_ESCAPEFLAGS-Struktur , die in Bitfeldflags angibt, wie Informationen freigegeben werden. Die OpenGL ICD sollte das HardwareAccess-Bitfeldflag angeben, um anzugeben, dass der Display-Miniporttreiber auf Grafikhardware zugreifen muss, sodass das Betriebssystem die zweite Synchronisierungsebene mit dem Display-Miniporttreiber für den DxgkDdiEscape-Aufruf durchführen muss.

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[in] PrivateDriverDataSize

Die Größe des Puffers in Bytes, auf den pPrivateDriverData verweist. Die OpenGL ICD muss die Größe des Puffers angeben, wenn die Funktion D3DKMTEscape 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 die 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 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 von Dxgkrnl.syssind) und das Verhalten des TDR-Prozesses des Betriebssystems zu steuern.