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

[入力] 以前に DxgkDdiCreateDoorbell を使用して作成された doorbell オブジェクトへの KMD ハンドル。

Flags

[入力]ドアベル接続フラグ を指定するDXGKARG_CONNECTDOORBELL_FLAGS 値のビットフィールド。 UMD が RequireSecondaryCpuVA フラグを使用してこのドアベルを作成した場合、 Dxgkrnl はこの DDI に RequireSecondaryAddress フラグを設定して、このドアベルに 2 つの物理アドレスが必要であることを KMD に通知します。

KernelCpuVirtualAddress

[out]KMD がこのドアベルに割り当てる物理アドレスにマップされたカーネルモード CPU 仮想アドレス。 Dxgkrnl は、このアドレスを 、D3DKMTCreateDoorbell の UMD に提供されたプロセスアドレス空間 CPU 仮想アドレスにマップします。 UMD はこのアドレスに特定の値を書き込み、実質的に "ドアベルを呼び出す" と書き込み、 hHwQueue での新しい作業の送信を GPU スケジューラに通知します。

SecondaryKernelCpuVirtualAddress

[out/optional]必要に応じて、KMD がこのドアベルに割り当てるセカンダリ物理アドレスにマップされたカーネルモード CPU 仮想アドレス。

Status

[out]kmd が pDoorbellStatusCpuVirtualAddress が指す UMD に表示されるページに書き込む KMD のD3DDDI_DOORBELLSTATUS値。この値は、D3DDDI_DOORBELL_STATUS_CONNECTEDまたはD3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFYにのみ指定できます。