Fungsi D3DKMTConnectDoorbell (d3dkmthk.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.

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

Sintaks

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

Parameter

unnamedParam1

[in] Arahkan ke struktur *D3DKMT_CONNECT_DOORBELL* yang menjelaskan bel pintu untuk terhubung.

Menampilkan nilai

D3DKMTConnectDoorbell mengembalikan STATUS_SUCCESS ketika OS berhasil menghubungkan bel pintu ke antrean perangkat keras dan UMD dapat menggunakan bel pintu ini untuk pengiriman kerja. Biasanya panggilan ini tidak boleh gagal; namun, kode kegagalan adalah dari GPU yang hilang atau menghentikan jenis skenario yang tidak dapat dipulihkan.

Keterangan

Setiap kali UMD mengirimkan pekerjaan baru ke antrean perangkat keras dan menyaring bel pintu, UMD harus membaca DoorbellStatusCPUVirtualAddress untuk memeriksa apakah cincin bel pintu berhasil. Jika gagal, UMD harus memanggil D3DKMTConnectDoorbell untuk menyambungkan kembali bel pintu lalu mencoba pengiriman lagi.

Bel pintu dapat terputus karena beberapa alasan:

Ketika bel pintu dibuat, OS menginisialisasinya dalam status "terputus", dan hanya menghubungkannya ketika UMD memanggil D3DKMTConnectDoorbell untuk pertama kalinya.
Bel pintu "menjadi korban" pada perangkat keras yang mendukung model bel pintu khusus. Artinya, bel pintu fisik antrean perangkat keras ini ditetapkan ke antrean perangkat keras lain. Penetapan ulang ini kemungkinan karena ada lebih banyak antrean perangkat keras yang dibuat pada GPU daripada bel pintu fisik.
Bel pintu terputus sebagai bagian dari menangguhkan antrean perangkat keras atau mematikan GPU.

Ketika UMD memanggil D3DKMTConnectDoorbell untuk menghubungkan bel pintu yang ditetapkan ke antrean perangkat keras, OS membuat panggilan DxgkDdiConnectDoorbell yang sesuai ke KMD, sehingga KMD dapat menemukan bel pintu fisik, menetapkannya ke antrean perangkat keras ini, dan membuat koneksi yang diperlukan antara antrean perangkat keras, bel pintu, penjadwal GPU dan sebagainya.

Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.