DXGKARG_SUBMITCOMMANDVIRTUAL結構（d3dkmddi.h）

發行項
02/06/2025

DXGKARG_SUBMITCOMMANDVIRTUAL 可用來將直接記憶體存取（DMA）緩衝區提交至支援使用 DxgkDdiSubmitCommandVirtual設備驅動器介面（DDI）進行虛擬尋址的內容。

語法

typedef struct _DXGKARG_SUBMITCOMMANDVIRTUAL {
  HANDLE                         hContext;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           DmaBufferSize;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferUmdPrivateDataSize;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMANDVIRTUAL;

成員

hContext

從 DxgkDdiCreateContext傳回的句柄。

DmaBufferVirtualAddress

送出程序內容中 DMA 緩衝區的虛擬位址。

DmaBufferSize

以位元組為單位的 DMA 緩衝區大小。

pDmaBufferPrivateData

驅動程式私人數據緩衝區的指標。

DmaBufferPrivateDataSize

驅動程式私用數據緩衝區的大小，以位元組為單位。

DmaBufferUmdPrivateDataSize

SubmitCommandCb中使用者模式驅動程式所設定的私人驅動程序數據大小，以位元組為單位。呼叫 SubmitCommandCb 時，DirectX 圖形核心會為大小等於 DXGK_CONTEXTINFO：：DmaBufferPrivateDataSize的私人驅動程式數據配置緩衝區。此大小是由 DxgkDdiCreateContext 呼叫中的核心模式驅動程式所報告。 DirectX 圖形核心會將驅動程式私用數據從 SubmitCommandCb 複製到配置的緩衝區。

SubmissionFenceId

驅動程式可以寫入通道緩衝區中柵欄命令的唯一標識碼，這是 DMA 緩衝區排入佇列以執行 GPU 的緩衝區。如需這些識別碼類型的詳細資訊，請參閱提供柵欄識別碼。

VidPnSourceId

視訊簡訊簡訊（VidPN）拓撲路徑中，以零起始的視訊呈現來源標識碼，用於翻轉作業。只有當 Flip 或 FlipWithNoWait 位字段旗標在 Flags 成員中設定時，這個成員才有效。

FlipInterval

D3DDDI_FLIPINTERVAL_TYPE型別值，指出翻轉間隔（也就是說，如果翻轉發生在零、一、二、三或四個垂直同步之後）。只有在旗標成員中設定 Flip 位欄位字段旗標時，FlipInterval 才有效。

Flags

DXGK_SUBMITCOMMANDFLAGS 結構，可識別要送出之 DMA 緩衝區的相關信息。

EngineOrdinal

保留供日後使用。

NodeOrdinal

建立內容之節點之以零起始的索引。當內容 NULL時，識別節點。