Fungsi D3DKMTDestroyDoorbell (d3dkmthk.h)
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.
D3DKMTDestroyDoorbell menghancurkan bel pintu.
Sintaks
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
Parameter
unnamedParam1
[in] Arahkan ke struktur D3DKMT_DESTROY_DOORBELL yang mengidentifikasi antrean perangkat keras yang bel pintunya akan dihancurkan.
Menampilkan nilai
D3DKMTDestroyDoorbell mengembalikan STATUS_SUCCESS ketika OS berhasil menghancurkan objek bel pintu. Jika hDoorbell menunjuk ke bel pintu yang valid, maka panggilan ini selalu berhasil; jika tidak, ia mengembalikan STATUS_INVALID_PARAMETER.
Keterangan
Ketika UMD memanggil D3DKMTDestroyDoorbell, OS melakukan hal berikut:
- Menghapus referensinya ke hRingBuffer dan ke alokasi hRingBufferControl milik bel pintu ini.
- Membebaskan pemetaan yang ditunjukkan doorbellStatusCPUVirtualAddress .
- Membebaskan pemetaan mode pengguna dan mode kernel yang ditunjukkan DoorbellCPUVirtuslAddress .
- Memanggil KMD [DxgkDdiDestroyDoorbell] sehingga KMD dapat memutuskan lokasi bel pintu fisik dan menghancurkan objek bel pintunya.
UMD tidak boleh menggunakan handel setelah memanggil D3DKMTDestroyDoorbell.
Untuk informasi selengkapnya, lihat Pengiriman kerja mode pengguna.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 11, versi 24H2 (WDDM 3.2) |
| Header | d3dkmthk.h |