D3DKMTDestroyDoorbell 函式 （d3dkmthk.h）
重要
某些資訊與發行前版本產品有關，在發行前版本產品可能經過大幅修改。 Microsoft未就此處提供的資訊提供任何明示或默示擔保。
D3DKMTDestroyDoorbell 摧毀門鈴。
語法
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
參數
unnamedParam1
[in]D3DKMT_DESTROY_DOORBELL 結構的指標，識別要終結其門鈴的硬體佇列。
傳回值
當 OS 成功終結門鈴物件時，D3DKMTDestroyDoorbell 會傳回STATUS_SUCCESS。 如果 hDoorbell 指向有效的門鈴，則此呼叫一律會成功;否則會傳回STATUS_INVALID_PARAMETER。
言論
當 UMD 呼叫 D3DKMTDestroyDoorbell時，OS 會執行下列動作：
- 拿掉其 hRingBuffer 的參考，以及 hRingBufferControl 屬於此門鈴的配置。
- 釋放 DoorbellStatusCPUVirtualAddress 指向的對應。
- 釋出 DoorbellCPUVirtuslAddress 指向的使用者模式和內核模式對應。
- 呼叫 KMD 的 [DxgkDdiDestroyDoorbell]，讓 KMD 可以中斷實體門鈴位置的連線，並終結其門鈴物件。
UMD 在呼叫 D3DKMTDestroyDoorbell之後，不得使用 句柄。
如需詳細資訊，請參閱 使用者模式工作提交。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 版本 24H2 （WDDM 3.2） |
| 標頭 | d3dkmthk.h |