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 |