DXGKDDI_ESCAPE fungsi panggilan balik (d3dkmddi.h)

Artikel
02/26/2024

Fungsi DxgkDdiEscape berbagi informasi dengan driver tampilan mode pengguna.

Sintaks

DXGKDDI_ESCAPE DxgkddiEscape;

NTSTATUS DxgkddiEscape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_ESCAPE pEscape
)
{...}

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX di parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in] pEscape

Penunjuk ke struktur DXGKARG_ESCAPE yang berisi informasi tentang informasi bersama.

Catatan Agar panggilan DxgkDdiEscape dilakukan di bawah tingkat kedua, bendera HardwareAccess harus diatur dalam struktur D3DDDI_ESCAPEFLAGS yang merupakan anggota DXGKARG_ESCAPE. Jika bendera ini tidak diatur, maka panggilan akan gagal.

Menampilkan nilai

DxgkDdiEscape mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	DxgkDdiEscape berhasil berbagi informasi.
STATUS_INVALID_PARAMETER	Parameter yang diteruskan ke DxgkDdiEscape berisi kesalahan yang mencegahnya selesai.
STATUS_NO_MEMORY	DxgkDdiEscape tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.
STATUS_PRIVILEGED_INSTRUCTION	DxgkDdiEscape mendeteksi instruksi nonprivileged (yaitu, instruksi yang mengakses memori di luar hak istimewa dari proses unit pemrosesan pusat [CPU] saat ini).
STATUS_ILLEGAL_INSTRUCTION	DxgkDdiEscape mendeteksi instruksi bahwa perangkat keras grafis tidak dapat mendukung.
STATUS_GRAPHICS_DRIVER_MISMATCH	Driver miniport tampilan tidak kompatibel dengan driver tampilan mode pengguna yang memulai panggilan ke DxgkDdiEscape.

Keterangan

Subsistem kernel grafis DirectX memanggil fungsi DxgkDdiEscape driver miniport tampilan setiap kali driver tampilan mode pengguna harus berbagi informasi dengan driver miniport tampilan dengan cara yang tidak didukung melalui komunikasi driver lainnya.

DxgkDdiEscape harus dibuat halaman.