DXGKARG_CONNECTDOORBELL结构（d3dkmddi.h）

项目
02/06/2025

重要

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

DXGKARG_CONNECTDOORBELL 结构包含 DxgkDdiConnectDoorbell的参数。

语法

typedef struct _DXGKARG_CONNECTDOORBELL {
  HANDLE                        hDoorbell;
  DXGKARG_CONNECTDOORBELL_FLAGS Flags;
  void                          *KernelCpuVirtualAddress;
  void                          *SecondaryKernelCpuVirtualAddress;
  D3DDDI_DOORBELLSTATUS         Status;
} DXGKARG_CONNECTDOORBELL;

成员

hDoorbell

[in]门铃对象的 KMD 句柄，以前使用 DxgkDdiCreateDoorbell创建。

Flags

[in]指定门铃连接标志的 DXGKARG_CONNECTDOORBELL_FLAGS 值的位字段。如果 UMD 使用此 DDI 中的 RequireSecondaryCpuVA 标志创建了此门铃，则 Dxgkrnl 设置此 DDI 中的 RequireSecondaryAddress 标志，以通知 KMD 此门铃需要两个物理地址。

KernelCpuVirtualAddress

[out]映射到 KMD 想要分配给此门铃的物理地址的内核模式 CPU 虚拟地址。 Dxgkrnl 会将此地址映射到进程地址空间 CPU 虚拟地址，该地址是在 D3DKMTCreateDoorbell中提供给 UMD 的。 UMD 会将特定值写入此地址，有效地“敲响门铃”，以通知 GPU 计划程序有关 hHwQueue的新工作提交。

SecondaryKernelCpuVirtualAddress

[out/optional]如果需要，映射到 KMD 希望分配给此门铃的辅助物理地址的内核模式 CPU 虚拟地址。

Status

[out]KMD 希望 Dxgkrnl 写入 pDoorbellStatusCpuVirtualAddress 指向的 UMD 可见页面的 D3DDDI_DOORBELLSTATUS 值。此值只能D3DDDI_DOORBELL_STATUS_CONNECTED或D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY。