D3DKMT_CREATE_DOORBELL 構造体 (d3dkmthk.h)

[アーティクル]
05/23/2024

D3DKMT_CREATE_DOORBELL構造体には、D3DKMTCreateDoorbell のパラメーターが含まれています。

構文

typedef struct _D3DKMT_CREATE_DOORBELL {
  D3DKMT_HANDLE                hHwQueue;
  D3DKMT_HANDLE                hRingBuffer;
  D3DKMT_HANDLE                hRingBufferControl;
  D3DKMT_CREATE_DOORBELL_FLAGS Flags;
  UINT                         PrivateDriverDataSize;
  void                         D3DKMT_PTR(
    VOID              *unnamedParam1,
    PrivateDriverData unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                      *unnamedParam1,
    DoorbellCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                               *unnamedParam1,
    DoorbellSecondaryCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                            *unnamedParam1,
    DoorbellStatusCPUVirtualAddress unnamedParam2
  );
  void                         D3DKMT_PTR(
    VOID                                                 *unnamedParam1,
    HwQueueProgressFenceLastQueuedValueCPUVirtualAddress unnamedParam2
  );
  D3DKMT_HANDLE                hDoorbell;
} D3DKMT_CREATE_DOORBELL;

メンバー

hHwQueue

[入力] D3DKMTCreateHwQueue の以前の呼び出しで作成されたハードウェアキューオブジェクトの UMD ハンドル。このハンドルは、ドアベルを割り当てる必要があるハードウェアキューを識別します。

hRingBuffer

[入力]UMD が以前に作成したリングバッファー割り当てへの UMD ハンドル。割り当ては GPU に表示され、既に常駐している必要があります。 Dxgkrnl は 、対応する DxgkDdiCreateDoorbell 呼び出しで、GPU 仮想アドレス (VA) とこの割り当てのサイズを KMD に渡します。 ResizeRingBufferOperation フラグは、UMD から KMD へのヒントであり、新しいサイズ変更されたリングバッファーを使用して、このハードウェアキューに対してドアベルが再作成されます。

hRingBufferControl

[入力/省略可能]UMD によって以前に作成されたリングバッファーコントロールの割り当てに対する UMD ハンドル。 UMD と KMD では、この割り当てを制御領域として使用して、必要に応じてリングバッファーの読み取り/書き込みポインターの場所を格納できます。 UMD が D3DKMTCreateDoorbell を呼び出すとき、割り当ては GPU に表示され、既に常駐している必要があります。 Dxgkrnl は 、対応する DxgkDdiCreateDoorbell 呼び出しで、GPU VA とこの割り当てのサイズを KMD に渡します。

Flags

[入力/省略可能]ドアベル作成フラグ を指定するD3DKMT_CREATE_DOORBELL_FLAGS 値のビットフィールド。

PrivateDriverDataSize

[入力] pPrivateDriverData が指すプライベートドライバーデータのサイズ (バイト単位)。

void D3DKMT_PTR( VOID *unnamedParam1, PrivateDriverData unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellSecondaryCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, DoorbellStatusCPUVirtualAddress unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, HwQueueProgressFenceLastQueuedValueCPUVirtualAddress unnamedParam2)

hDoorbell

[out]新しく作成された doorbell オブジェクトへのランタイムハンドル。