DXGKARG_CREATEDOORBELL 结构 (d3dkmddi.h)

重要

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

DXGKARG_CREATEDOORBELL 结构包含 KMD 的 DxgkDdiCreateDoorbell 回调函数的参数。

语法

typedef struct _DXGKARG_CREATEDOORBELL {
  HANDLE                       hHwQueue;
  HANDLE                       hDoorbell;
  UINT                         PrivateDriverDataSize;
  void                         *PrivateDriverData;
  HANDLE                       hRingBuffer;
  HANDLE                       hRingBufferControl;
  DXGKARG_CREATEDOORBELL_FLAGS Flags;
} DXGKARG_CREATEDOORBELL;

成员

hHwQueue

[in]KMD 硬件队列对象的句柄,该对象是在之前对 DxgkddiCreateHwQueue 的调用中创建的。

hDoorbell

[in/out]作为输入,包含运行时对门铃的句柄。 KMD 可以将输入句柄存储在其跟踪结构中。 作为输出,当 KMD 完成创建门铃时, hDoorbell 包含 KMD 的内核模式句柄到门铃。

PrivateDriverDataSize

[in]与门铃关联的驱动程序专用数据的大小(以字节为单位)。

PrivateDriverData

[in/out]指向与门铃关联的驱动程序专用数据的指针。

hRingBuffer

[in]前面由 UMD 创建的 环形缓冲区分配的句柄。 此分配是 GPU 可见且已驻留的。 ResizeRingBufferOperation 标志是从 UMD 到 KMD 的一个提示,即正在为此硬件队列重新创建一个门铃,其中包含一个新的重设大小的环形缓冲区。

hRingBufferControl

[in]前面由 UMD 创建的 环形缓冲区控制分配的 KMD 句柄。 如果需要,UMD 和 KMD 可以将此分配用作控制区域来存储环形缓冲区读/写指针位置。 分配必须是 GPU 可见且已驻留的。

Flags

指定门铃创建标志的 DXGKARG_CREATEDOORBELL_FLAGS 值的位字段。

注解

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

要求

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

另请参阅

D3DKMTCreateAllocation

DXGKARG_CREATEDOORBELL_FLAGS

DxgkDdiCreateDoorbell