DXGKDDI_CONNECTDOORBELL fungsi panggilan balik (d3dkmddi.h)

Artikel
05/23/2024

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.

DxgkDdiConnectDoorbell menyambungkan (atau menyambungkan kembali) objek bel pintu yang dibuat sebelumnya ke antrean perangkat keras.

Sintaks

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parameter

pArgs

[masuk/keluar] Penunjuk ke struktur DXGKARG_CONNECTDOORBELL yang menjelaskan bel pintu untuk disambungkan.

Menampilkan nilai

DxgkDdiConnectDoorbell mengembalikan STATUS_SUCCESS jika KMD berhasil menyambungkan objek bel pintunya ke antrean perangkat keras yang ditentukan. Panggilan ini biasanya tidak boleh gagal; namun, kode kegagalan yang dikembalikan adalah dari GPU yang hilang atau berhenti jenis skenario yang tidak dapat dipulihkan.

Keterangan

Saat UMD memanggil D3DKMTConnectDoorbell, OS memanggil DxgkDdiConnectDoorbell sehingga KMD dapat melakukan hal berikut:

Berikan alamat virtual CPU yang dipetakan ke lokasi bel pintu fisik.
Buat koneksi yang diperlukan antara objek antrean perangkat keras, objek bel pintu, alamat fisik bel pintu, penjadwal GPU, dan sebagainya.

Saat kembali dari DDI ini, KMD harus mempertimbangkan alamat fisik ini sebagaimana dicadangkan untuk antrean perangkat keras khusus ini. Namun, OS tidak memiliki persyaratan keunikan untuk alamat fisik bel pintu. Artinya, KMD dapat memilih untuk berbagi alamat fisik yang sama dengan beberapa bel pintu logis/antrean perangkat keras tergantung pada implementasi perangkat keras. Misalnya, beberapa perangkat keras mungkin memilih untuk menetapkan alamat fisik yang sama ke semua antrean perangkat keras dari satu konteks perangkat keras. Bahkan ada kemungkinan bahwa beberapa bel pintu logis berbagi halaman fisik 4KB yang sama tetapi menggunakan offset unik dalam halaman.

Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.