struktur D3DKMT_ESCAPE (d3dkmthk.h)

Artikel
09/07/2023

Struktur D3DKMT_ESCAPE menjelaskan informasi yang ditukar dengan driver miniport tampilan.

Sintaks

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;

Anggota

[in] hAdapter

Handel ke adaptor grafis tempat informasi dipertukarkan.

[in] hDevice

Handel ke perangkat tampilan yang secara opsional ditentukan jika informasi yang akan ditukarkan khusus untuk perangkat tertentu.

[in] Type

Nilai jenis D3DKMT_ESCAPETYPE yang menunjukkan untuk bertukar informasi dengan driver miniport tampilan atau untuk mengontrol komponen mode kernel. Tabel berikut ini memperlihatkan nilai yang mungkin.

Nilai	Makna
D3DKMT_ESCAPE_DRIVERPRIVATE (0)	Anggota pPrivateDriverData ditargetkan pada driver miniport tampilan. Vendor perangkat keras mendefinisikan format data escape.
D3DKMT_ESCAPE_VIDMM (1)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengontrol manajer memori video (yang merupakan bagian dari Dxgkrnl.sys). Buffer yang ditujukan pPrivateDriverData berisi struktur D3DKMT_VIDMM_ESCAPE yang mendukung berbagai jenis kontrol manajer memori video.
D3DKMT_ESCAPE_TDRDBGCTRL (2)	Jangan gunakan. Hanya untuk tujuan pengujian. Operasi escape memungkinkan pengguna mengontrol perilaku proses Timeout Detection and Recovery (TDR) sistem operasi. Fungsionalitas ini dinonaktifkan secara default. Untuk mengaktifkan fungsionalitas ini, nilai registri DWORD TdrTestMode = TdrTestMode, yang disimpan dalam kunci HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\GraphicsDrivers, harus diatur ke 1. Anggota PrivateDriverDataSize diatur ke sizeof(int). Anggota pPrivateDriverData diatur ke bilangan bulat dengan nilai dari jenis enumerasi D3DKMT_TDRDBGCTRLTYPE .
D3DKMT_ESCAPE_VIDSCH (3)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengontrol penjadwal unit pemrosesan grafis (GPU) (yang merupakan bagian dari Dxgkrnl.sys). Buffer yang ditunjuk pPrivateDriverData berisi struktur D3DKMT_VIDSCH_ESCAPE yang mendukung kontrol preemption dan menangguhkan atau melanjutkan penjadwal.
D3DKMT_ESCAPE_DEVICE (4)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengontrol perangkat tampilan. Buffer yang ditujukan pPrivateDriverData berisi struktur D3DKMT_DEVICE_ESCAPE yang mendukung mendapatkan sumber video yang ada dari alokasi utama.
D3DKMT_ESCAPE_DMM (5)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengontrol manajer mode tampilan. Buffer yang ditujukan pPrivateDriverData berisi struktur D3DKMT_DMM_ESCAPE .
D3DKMT_ESCAPE_DEBUG_SNAPSHOT (6)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengambil buffer rekam jepret debug. Buffer yang ditujukan pPrivateDriverData berisi struktur D3DKMT_DEBUG_SNAPSHOT_ESCAPE .
D3DKMT_ESCAPE_SETDRIVERUPDATESTATUS (7)	Jangan gunakan. Hanya untuk tujuan pengujian. OpenGL ICD mengatur status pembaruan driver miniport tampilan.
D3DKMT_ESCAPE_DRT_TEST (8)	Jangan gunakan. Hanya untuk tujuan pengujian.
D3DKMT_ESCAPE_DIAGNOSTICS (9)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_SNAPSHOT (10)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_OUTPUTDUPL_DIAGNOSTICS (11)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_BDD_PNP (12)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_BDD_FALLBACK (13)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_ACTIVATE_SPECIFIC_DIAG(14)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_MODES_PRUNED_OUT(15)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_WQHL_INFO(16)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_BRIGHTNESS(17)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_EDID_CACHE(18)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_GENERIC_ADAPTER_DIAG_INFO(19)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_MIRACAST_DISPLAY_REQUEST (20)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.
D3DKMT_ESCAPE_HISTORY_BUFFER_STATUS (21)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.
D3DKMT_ESCAPE_MIRACAST_ADAPTER_DIAG_INFO (23)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.
D3DKMT_ESCAPE_WIN32K_START(1024)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_WIN32K_HIP_DEVICE_INFO(1024)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_WIN32K_QUERY_CD_ROTATION_BLOCK (1025)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.
D3DKMT_ESCAPE_WIN32K_DPI_INFO (1026)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.
D3DKMT_ESCAPE_WIN32K_PRESENTER_VIEW_INFO (1027)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.
D3DKMT_ESCAPE_WIN32K_SYSTEM_DPI (1028)	Jangan gunakan. Hanya untuk tujuan pengujian. Didukung dimulai dengan Windows 8.1.

[in] Flags

Struktur D3DDDI_ESCAPEFLAGS yang menunjukkan, dalam bendera bidang bit, cara berbagi informasi. OpenGL ICD harus menentukan bendera bit-field HardwareAccess untuk menunjukkan bahwa driver miniport tampilan harus mengakses perangkat keras grafis sedemikian rupa sehingga sistem operasi harus melakukan tingkat sinkronisasi kedua ke driver miniport tampilan untuk panggilan DxgkDdiEscape .

[in/out] pPrivateDriverData

Penunjuk ke buffer yang dialokasikan OpenGL ICD yang berisi informasi bahwa OpenGL ICD bertukar dengan driver miniport tampilan atau menggunakan untuk mengontrol komponen mode kernel. Tabel berikut ini menjelaskan konten buffer yang dituju pPrivateDriverData , bergantung pada nilai Jenis.

Nilai anggota Tipe	Konten buffer pPrivateDriverData
D3DKMT_ESCAPE_DRIVERPRIVATE	Khusus pengemudi. Buffer tidak dapat digunakan kecuali ada coupling ketat antara OpenGL ICD dan driver miniport tampilan.
D3DKMT_ESCAPE_VIDMM	Jangan gunakan. Hanya untuk tujuan pengujian. Struktur D3DKMT_VIDMM_ESCAPE .
D3DKMT_ESCAPE_TDRDBGCTRL	Jangan gunakan. Hanya untuk tujuan pengujian. Jenis enumerasi D3DKMT_TDRDBGCTRLTYPE .
D3DKMT_ESCAPE_VIDSCH	Jangan gunakan. Hanya untuk tujuan pengujian. Struktur D3DKMT_VIDSCH_ESCAPE .
D3DKMT_ESCAPE_DEVICE	Jangan gunakan. Hanya untuk tujuan pengujian. Struktur D3DKMT_DEVICE_ESCAPE .
D3DKMT_ESCAPE_DMM	Jangan gunakan. Hanya untuk tujuan pengujian. Struktur D3DKMT_DMM_ESCAPE .
D3DKMT_ESCAPE_DEBUG_SNAPSHOT	Jangan gunakan. Hanya untuk tujuan pengujian. Struktur D3DKMT_DEBUG_SNAPSHOT_ESCAPE .

[in] PrivateDriverDataSize

Ukuran, dalam byte, dari buffer yang dituju pPrivateDriverData . OpenGL ICD harus menentukan ukuran buffer saat memanggil fungsi D3DKMTEscape .

[in] hContext

Handel ke konteks yang secara opsional ditentukan jika informasi yang akan ditukar khusus untuk konteks perangkat tertentu. Jika OpenGL ICD menetapkan hContext ke nilai non-NULL, ICD juga harus mengatur hDevice ke nilai non-NULL, dan hDevice harus sesuai dengan perangkat yang memiliki konteks.

Keterangan

Untuk tujuan pengujian, OpenGL ICD dapat meneruskan penunjuk ke struktur D3DKMT_ESCAPE dalam panggilan ke fungsi D3DKMTEscape untuk mengontrol manajer memori video dan penjadwal GPU (yang merupakan bagian dari Dxgkrnl.sys) dan perilaku proses TDR sistem operasi.