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 |