DXGKDDI_DISCONNECTDOORBELL fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Penting

Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Fungsi DxgkDdiDisconnectDoorbell memutuskan sambungan objek bel pintu yang sebelumnya terhubung dari antrean perangkat keras.

Sintaks

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

[masuk/keluar] Penunjuk ke struktur DXGKARG_DISCONNECTDOORBELL yang menjelaskan bel pintu untuk memutuskan sambungan.

Menampilkan nilai

DxgkDdiDisconnectDoorbell harus berhasil dan mengembalikan STATUS_SUCCESS.

Keterangan

OS memanggil DxgkDdiDisconnectDoorbell untuk membuka peta lokasi bel pintu fisik yang ditetapkan ke bel pintu ini. KMD harus memutuskan sambungan antrean perangkat keras, alamat fisik dan mesin bel pintu, dll. Lokasi bel pintu fisik dapat ditetapkan ke beberapa objek bel pintu logis lainnya.

KMD tidak boleh menghancurkan atau membebaskan objek lain yang terkait dengan hDoorbell karena objek bel pintu tidak dihancurkan dan dapat disambungkan kembali di titik selanjutnya.

Saat kembali dari panggilan DDI ini, Dxgkrnl melakukan langkah-langkah berikut untuk memutuskan bel pintu:

Memutar mode pengguna DoorbellCpuVirtualAddress ke halaman dummy sehingga UMD tidak dapat lagi menulis ke lokasi bel pintu fisik.
Menulis D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY ke DoorbellStatusCpuVirtualAddress sehingga UMD tahu bel pintu terputus.