Fungsi D3DKMTCreateDoorbell (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.

Fungsi D3DKMTCreateDoorbell membuat bel pintu GPU untuk antrean perangkat keras D3D untuk pengiriman kerja mode pengguna.

Sintaks

NTSTATUS D3DKMTCreateDoorbell(
  D3DKMT_CREATE_DOORBELL *unnamedParam1
);

Parameter

unnamedParam1

[masuk/keluar] Arahkan ke struktur D3DKMT_CREATE_DOORBELL yang menjelaskan bel pintu yang akan dibuat.

Menampilkan nilai

D3DKMTCreateDoorbell mengembalikan STATUS_SUCCESS ketika OS berhasil membuat bel pintu untuk antrean perangkat keras ini yang dapat digunakan UMD untuk pengiriman kerja. Kode pengembalian kegagalan berarti bahwa bel pintu tidak dibuat dan UMD tidak dapat menggunakannya untuk pengiriman kerja.

Keterangan

D3DKMTCreateDoorbell membuat objek bel pintu yang diinisialisasi sebagai terputus. UMD harus memanggil D3DKMTConnectDoorbell sebelum menggunakan bel pintu ini untuk mengirimkan perintah pada antrean perangkat keras.

Ketika UMD memanggil D3DKMTCreateDoorbell, OS melakukan panggilan yang sesuai ke panggilan balik DxgkDdiCreateDoorbell KMD di mana KMD dapat menginisialisasi status bel pintunya.

Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.