D3DKMTCreateDoorbell 函数 (d3dkmthk.h)

重要

某些信息与预发行产品相关,在商业发布之前,该产品可能会进行实质性修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。

D3DKMTCreateDoorbell 函数为用户模式工作提交的 D3D 硬件队列创建 GPU 门铃。

语法

NTSTATUS D3DKMTCreateDoorbell(
  D3DKMT_CREATE_DOORBELL *unnamedParam1
);

参数

unnamedParam1

[in/out]指向描述要创建的门铃 的D3DKMT_CREATE_DOORBELL 结构的指针。

返回值

当 OS 成功为此硬件队列创建门铃时,D3DKMTCreateDoorbell 将返回STATUS_SUCCESS,UMD 可用于提交工作。 任何故障返回代码都表示未创建门铃,UMD 无法将其用于工作提交。

注解

D3DKMTCreateDoorbell 创建一个门铃对象,该对象初始化为已断开连接。 UMD 必须先调用 D3DKMTConnectDoorbell ,然后才能使用此门铃在硬件队列上提交命令。

当 UMD 调用 D3DKMTCreateDoorbell 时,OS 会对 KMD 的 DxgkDdiCreateDoorbell 回调进行相应的调用,KMD 可在其中初始化其门铃状态。

有关详细信息,请参阅 用户模式工作提交

要求

要求
最低受支持的客户端 Windows 11,版本 24H2 (WDDM 3.2)
标头 d3dkmthk.h

另请参阅

D3DKMTConnectDoorbell

D3DKMT_CREATE_DOORBELL

DxgkDdiConnectDoorbell

DxgkDdiCreateDoorbell

D3DKMTDestroyDoorbell