DXGKDDI_CREATEDOORBELL回调函数 (d3dkmddi.h)

项目
02/23/2024

重要

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

OS 调用 KMD 的 DxgkDdiCreateDoorbell 回调函数，为硬件队列创建门铃。

语法

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

参数

pArgs

[in/out]指向描述门铃 的DXGKARG_CREATEDOORBELL 结构的指针。

返回值

如果 KMD 能够成功为指定的硬件队列创建其门铃对象，并且 UMD 可以使用此门铃提交工作，DxgkDdiCreateDoorbell 将返回STATUS_SUCCESS。否则，它将返回相应的 NTSTATUS 错误代码。如果 KMD 返回任何失败代码，则 UMD 无法使用门铃提交工作。

注解

当 UMD 调用 D3DKMTCreateDoorbell 为硬件队列创建门铃时，OS 会对 KMD 发出相应的 DxgkDdiCreateDoorbell 调用，以便 KMD 可以初始化其门铃结构。

KMD 的 DxgkDdiCreateDoorbell 函数应仅创建和初始化其门铃数据结构。它不应将物理门铃位置分配给此门铃对象，因为此操作是在后续调用 DxgkDdiConnectDoorbell 期间完成的。此延迟分配可确保物理门铃在硬件队列和门铃创建过程中不会用空，只会在 UMD 从未向它提交命令或以后开始提交命令的情况下浪费。这样，仅当实际需要时才使用物理门铃。