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 分配的引用。
  • 释放 pDoorbellStatusCPUVirtualAddress 指向的 映射。
  • 释放 pDoorbellCPUVirtuslAddress 指向的用户模式和内核模式映射。
  • 调用 KMD 的 [DxgkDdiDestroyDoorbell]，以便 KMD 可以断开物理门铃位置并销毁其门铃对象。

UMD 在调用 D3DKMTDestroyDoorbell 后不得使用该句柄。

要求

要求 值
最低受支持的客户端 WIN11_FUTURE
标头 d3dkmthk.h

另请参阅

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell