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 |