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

[in]在 呼叫 D3DKMTCreateHwQueue 之前建立的硬體佇列物件 UMD 句柄。此句柄會識別需要指派門鈴的硬體佇列。

hRingBuffer

[in]UMD 處理先前建立的通道緩衝區配置。配置必須是 GPU 可見且已存在。 Dxgkrnl 會將 GPU 虛擬位址 (VA) 和此配置的大小傳遞給對應 DxgkDdiCreateDoorbell 呼叫中的 KMD 。 ResizeRingBufferOperation 旗標是從UMD到 KMD 的提示，是針對此硬體佇列重新建立門鈴，並具有新的重設大小環形緩衝區。

hRingBufferControl

[in/optional]UMD 先前由 UMD 建立之通道緩衝區控件配置的 UMD 句柄。 UMD 和 KMD 可以使用此配置作為控制區域，視需要儲存通道緩衝區讀取/寫入指標位置。配置必須是 GPU 可見，且已在 UMD 呼叫 D3DKMTCreateDoorbell 時存在。 Dxgkrnl 會將此配置的 GPU VA 和大小傳遞給對應 DxgkDdiCreateDoorbell 呼叫中的 KMD 。

Flags

[in/optional]指定門鈴建立旗標 之D3DKMT_CREATE_DOORBELL_FLAGS 值的位欄位。

PrivateDriverDataSize

[in] 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]新建立之門鈴對象的運行時間句柄。