DXGKDDI_CREATEDOORBELL 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.

OS memanggil fungsi panggilan balik DxgkDdiCreateDoorbell KMD untuk membuat bel pintu untuk antrean perangkat keras.

Sintaks

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Parameter

pArgs

[masuk/keluar] Penunjuk ke struktur DXGKARG_CREATEDOORBELL yang menggambarkan bel pintu.

Menampilkan nilai

DxgkDdiCreateDoorbell mengembalikan STATUS_SUCCESS jika KMD berhasil membuat objek bel pintunya untuk antrean perangkat keras yang ditentukan, dan UMD dapat menggunakan bel pintu ini untuk pengiriman kerja. Jika tidak, kode kesalahan NTSTATUS akan ditampilkan. UMD tidak dapat menggunakan bel pintu untuk pengiriman kerja jika KMD mengembalikan kode kegagalan apa pun.

Keterangan

Ketika UMD memanggil D3DKMTCreateDoorbell untuk membuat bel pintu untuk antrean perangkat keras, OS membuat panggilan DxgkDdiCreateDoorbell yang sesuai ke KMD sehingga KMD dapat menginisialisasi struktur bel pintunya.

Fungsi DxgkDdiCreateDoorbell KMD hanya boleh membuat dan menginisialisasi struktur data bel pintunya. Seharusnya tidak menetapkan lokasi bel pintu fisik ke objek bel pintu ini karena itu dilakukan selama panggilan berikutnya ke DxgkDdiConnectDoorbell. Tugas malas ini memastikan bahwa bel pintu fisik tidak habis selama antrean perangkat keras dan pembuatan bel pintu, hanya untuk membuang-buang waktu jika UMD tidak pernah mengirimkan perintah ke sana atau mulai mengirimkan perintah di lain waktu. Dengan cara ini, bel pintu fisik hanya digunakan ketika benar-benar diperlukan.

Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.