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 使用 RequireSecondaryCpuVA 旗標建立此門鈴，則 Dxgkrnl 會設定此 DDI 中 RequireSecondaryAddress 旗標，以通知 KMD 此門鈴需要兩個實體位址。

KernelCpuVirtualAddress

[out]對應至 KMD 想要指派給此門鈴之實體位址的核心模式 CPU 虛擬位址。 Dxgkrnl 會將此位址對應至進程位址空間 CPU 虛擬位址，該位址是在 D3DKMTCreateDoorbell中提供給 UMD 的 CPU 虛擬位址。 UMD 會將特定值寫入此位址，有效地「響鈴」，以通知 GPU 排程器有關 hHwQueue的新工作提交。

SecondaryKernelCpuVirtualAddress

[out/optional]若需要，則對應至 KMD 想要指派給此門鈴之次要實體位址的核心模式 CPU 虛擬位址。

Status

[out]D3DDDI_DOORBELLSTATUS 值，KMD 想要 Dxgkrnl 寫入 pDoorbellStatusCpuVirtualAddress 指向的 UMD 可見頁面。此值只能D3DDDI_DOORBELL_STATUS_CONNECTED或D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY。