DXGKARG_SUBMITCOMMAND 結構 (d3dkmddi.h)

發行項
02/23/2024

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 (，例如，在電源管理) 期間收回整個畫面緩衝區內容的分頁作業。分頁作業是由 Flags 成員中的分頁位欄位字段旗標來表示。

hContext

[in]如果驅動程式是多引擎感知 (，則驅動程式支援建立內容) ，這是提交要求源自的裝置內容的句柄。內容句柄會提供給驅動程式的 DxgkDdiSubmitCommand 函式，該聯集DXGKARG_SUBMITCOMMAND包含。

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

DmaBufferSegmentId

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

如果驅動程式指出不要將 DMA 緩衝區對應至區段，則標識碼可以是零，方法是在呼叫驅動程式的 DxgkDdiCreateContext 函式中，將DXGK_CONTEXTINFO結構的 DmaBufferSegmentSet 成員設定為 0。如果 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