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]先前使用 DxgkDdiCreateDoorbell 建立之門鈴物件的 KMD 句柄。

Flags

[in]指定門鈴連接旗標之 DXGKARG_CONNECTDOORBELL_FLAGS 值的位欄位。如果 UMD 使用 RequireSecondaryCpuVA 旗標建立此門鈴， 則 Dxgkrnl 會在此 DDI 中設定 RequireSecondaryAddress 旗標，以通知 KMD 此門鈴需要兩個實體位址。

KernelCpuVirtualAddress

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

SecondaryKernelCpuVirtualAddress

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

Status

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