DXGKARG_CONNECTDOORBELL 结构 (d3dkmddi.h)

项目
05/23/2024

重要

某些信息与预发行产品相关，该产品在商业发布之前可能会进行重大修改。对于此处提供的信息，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 使用 RequireSecondaryCpuVA 标志创建了此门铃，则 Dxgkrnl 在此 DDI 中设置 RequireSecondaryAddress 标志，以通知 KMD 此门铃需要两个物理地址。

KernelCpuVirtualAddress

[out]映射到 KMD 要分配给此门铃的物理地址的内核模式 CPU 虚拟地址。 Dxgkrnl 将此地址映射到在 D3DKMTCreateDoorbell 中提供给 UMD 的进程地址空间 CPU 虚拟地址。 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。