DXGKARG_SUBMITCOMMAND結構（d3dkmddi.h）

發行項
02/06/2025

DXGKARG_SUBMITCOMMAND 結構描述顯示迷你埠驅動程式在呼叫 dxgkDdiSubmitCommand 期間提交至硬體命令執行單位的直接記憶體存取（DMA）緩衝區。

語法

typedef struct _DXGKARG_SUBMITCOMMAND {
  union {
    HANDLE hDevice;
    HANDLE hContext;
  };
  UINT                           DmaBufferSegmentId;
  PHYSICAL_ADDRESS               DmaBufferPhysicalAddress;
  UINT                           DmaBufferSize;
  UINT                           DmaBufferSubmissionStartOffset;
  UINT                           DmaBufferSubmissionEndOffset;
  VOID                           *pDmaBufferPrivateData;
  UINT                           DmaBufferPrivateDataSize;
  UINT                           DmaBufferPrivateDataSubmissionStartOffset;
  UINT                           DmaBufferPrivateDataSubmissionEndOffset;
  UINT                           SubmissionFenceId;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
  DXGK_SUBMITCOMMANDFLAGS        Flags;
  UINT                           EngineOrdinal;
  D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
  UINT                           NodeOrdinal;
} DXGKARG_SUBMITCOMMAND;

成員

hDevice

[in]如果驅動程式不是多引擎感知（也就是驅動程式不支持內容建立），hDevice 是提交要求源自的顯示裝置（圖形內容）的句柄。裝置句柄會提供給驅動程式的 DxgkDdiSubmitCommand 函式，該聯集包含 DXGKARG_SUBMITCOMMAND。

對於某些分頁作業，hDevice 為 NULL（例如，在電源管理期間收回整個畫面緩衝區內容的分頁作業）。分頁作業會以旗標成員中的分頁位欄位字段旗標表示。

hContext

[in]如果驅動程式具有多引擎感知功能（也就是驅動程式支持內容建立），則為提交要求源自之裝置內容的句柄。內容句柄會提供給驅動程式的 DxgkDdiSubmitCommand 函式，該函式 DXGKARG_SUBMITCOMMAND 包含。

對於某些分頁作業，hContext 為 NULL（例如，在電源管理期間收回整個畫面緩衝區內容的分頁作業）。分頁作業會以旗標成員中的分頁位欄位字段旗標表示。

DmaBufferSegmentId

[in]DMA 緩衝區分頁到的記憶體區段標識碼。

如果驅動程式指示不要將 DMA 緩衝區對應至區段，則標識碼可以是零，方法是將 DXGK_CONTEXTINFO 結構的 DmaBufferSegmentSet 成員設定為 0，以呼叫驅動程式 的 dxgkDdiCreateContext 函式。如果 DmaBufferSegmentId 為零，則 DMA 緩衝區會配置為系統記憶體的連續區塊。

DmaBufferPhysicalAddress

[in]PHYSICAL_ADDRESS數據類型（定義為LARGE_INTEGER），表示 DMA 緩衝區分頁所在的實體位址。

如果 DmaBufferSegmentId 為零，DmaBufferPhysicalAddress 是 DMA 緩衝區所在系統記憶體中的實體位址。

如果 DmaBufferSegmentId 為非零，DmaBufferPhysicalAddress 是 DMA 緩衝區的區段實體位址;也就是說，位址會指向光圈區段的實體位址，這是實體記憶體中定義的連續地址空間（DXGK_SEGMENTDESCRIPTOR。BaseAddress + DmaBuffer.SegmentOffset）。

請注意，DmaBufferPhysicalAddress 一律是指 DMA 緩衝區的開頭，即使驅動程式可能需要修補或提交不包含 DMA 緩衝區開頭的 DMA 緩衝區區段（也就是說，如果 DmaBufferSubmissionStartOffset 成員為非零）。

DmaBufferSize

[in]DMA 緩衝區的大小，以位元組為單位。

DmaBufferSize 代表 DMA 緩衝區的整個長度;不過，修補或送出的要求可能只參考 DMA 緩衝區的一部分。

DmaBufferSubmissionStartOffset

[in]位移，以位元組為單位，從 DMA 緩衝區的開頭到需要修補或送出之 DMA 緩衝區部分的開頭。在修補時間收到的位移符合提交時間收到的位移。

DmaBufferSubmissionEndOffset

[in]位移，以位元組為單位，從 DMA 緩衝區的開頭到需要修補或送出之 DMA 緩衝區部分的結尾。在修補時間收到的位移符合提交時間收到的位移。

pDmaBufferPrivateData

[in]驅動程式駐地私用數據的指標，與在 DxgkDdiRender、DxgkDdiPresent或 DxgkDdiPatch 函式期間填入的 DMA 緩衝區相關聯。

對於分頁作業，單一分頁緩衝區會用於多個獨立提交。在該案例中，驅動程式可以藉由在呼叫其 DxgkDdiBuildPagingBuffer 函式時傳回適當的私人驅動程式數據指標，讓所有提交的單一驅動程式私人數據範圍，或針對每個提交傳回一個。

DmaBufferPrivateDataSize