DXGKARG_CONNECTDOORBELL 結構 (d3dkmddi.h)

  • 發行項

重要

有些資訊與發行前版本產品有關，在正式發行前可能會大幅修改。 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]對應至 KMD 想要指派給此門鈴之實體位址的核心模式 CPU 虛擬位址。 Dxgkrnl 會將此位址對應至 D3DKMTCreateDoorbell 中提供給 UMD 的進程地址空間 CPU 虛擬位址。 UMD 會將特定值寫入此位址，有效地「響鈴」，以通知 GPU 排程器在 HwQueue1 上提交新工作。

SecondaryKernelCpuVirtualAddress

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

Status

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

規格需求

需求 值
最低支援的用戶端 WIN11_FUTURE
標頭 d3dkmddi.h

另請參閱

D3DDDI_DOORBELLSTATUS

D3DKMTCreateDoorbell

DXGKARG_CONNECTDOORBELL_FLAGS

DxgkDdiConnectDoorbell