DXGK_SUBMITCOMMANDFLAGS 結構 (d3dkmddi.h)

  • 發行項

DXGK_SUBMITCOMMANDFLAGS 結構會在位字段旗標中識別直接記憶體存取 (DMA) 緩衝區的相關信息，以提交至圖形處理單位， (GPU) 。

語法

typedef struct _DXGK_SUBMITCOMMANDFLAGS {
  union {
    struct {
      UINT Paging : 1;
      UINT Present : 1;
      UINT RedirectedPresent : 1;
      UINT NullRendering : 1;
      UINT Flip : 1;
      UINT FlipWithNoWait : 1;
      UINT ContextSwitch : 1;
      UINT Resubmission : 1;
      UINT VirtualMachineData : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 24;
#elif
      UINT Reserved : 25;
#else
      UINT Reserved : 26;
#endif
    };
    UINT Value;
  };
} DXGK_SUBMITCOMMANDFLAGS;

成員

Paging

[in]UINT 值，指定 DMA 緩衝區是否為包含分頁作業的分頁緩衝區。

設定這相當於 (0x00000001) 設定 32 位 Value 成員的第一個位。

Present

[in]UINT 值，指定 DMA 緩衝區是否包含目前作業。 DMA 緩衝區是由驅動程式的 DxgkDdiPresent函式所產生。

設定這相當於 (0x00000002) 設定 32 位 Value 成員的第二個位。

RedirectedPresent

[in]UINT 值，指定 DMA 緩衝區是否包含重新導向的目前作業，這是屬於顯示 Windows 管理員的共用配置。 DMA 緩衝區是由驅動程式的 DxgkDdiRender 函式所產生。

設定這相當於 (0x00000004) 設定 32 位 Value 成員的第三個位。

NullRendering

[in]UINT 值，指定驅動程式是否應該模擬將 DMA 緩衝區插入環形 (，也就是驅動程式是否應該在 DMA 緩衝區結尾產生柵欄中斷) ;不過，驅動程式不應該實際執行 (轉譯) DMA 緩衝區。 NullRendering 位字段旗標只會在效能調查和偵錯期間設定，以模擬無限快速的轉譯引擎，而該引擎仍必須執行 DMA 緩衝區提交和訊號的額外負荷。 一般作業期間永遠不會設定 NullRendering。

設定這相當於設定 32 位 Value 成員的第四個位 (0x00000008) 。

Flip

[in]UINT 值，指定 DMA 緩衝區是否包含翻轉作業。

設定這相當於 (0x00000010) 設定 32 位 Value 成員的第五個位。

FlipWithNoWait

[in]UINT 值，指定 DMA 緩衝區是否包含翻轉作業，而不需內建等候下一個垂直同步處理。

設定這相當於設定 32 位 Value 成員的第六個位 (0x00000020) 。

ContextSwitch

[in]從 Windows 8 開始支援。

UINT 值，指定 GPU 應該從目前的執行內容切換至 Null 內容。

從 Windows 8 開始，操作系統會在嘗試移動或收回屬於目前在 GPU 上執行的內容時，明確要求 GPU 切換至 Null 內容。 內容交換器要求是藉由提交長度為零的 DMA 緩衝區與 ContextSwitch 成員集來執行。

如果目前內容正在執行使用分頁緩衝區的作業，內容切換命令會與 Paging 成員一起提交，也會設定為一個。

設定這相當於設定 32 位 Value 成員的第七個位 (0x00000040) 。

Resubmission

[in]指出此 DMA 封包是否因為先前的先佔而重新提交至 GPU。 在 WDDM 2.0 中， DXGKARG_SUBMITCOMMAND 和 DxgkDdiSubmitCommandVirtual 都會在第一個 DMA 封包提交時將此旗標設定為零，並在因為先前的先佔而重新提交封包時設定為一個。 不論先前是否已先占封包，旗標都會在WDDM 1.x 中設定為零。

從Windows 10 開始支援。

VirtualMachineData

[in]表示提交來自半虛擬化配接器。

Reserved

[in]這個成員是保留的，而且應該設定為零。

Value

[in] 聯集中的成員，DXGK_SUBMITCOMMANDFLAGS 包含一個可識別 DMA 緩衝區相關信息的 32 位值。

規格需求

需求 值
最低支援的用戶端 Windows Vista
標頭 d3dkmddi.h (include D3dkmddi.h)

另請參閱

DXGKARG_SUBMITCOMMAND

DxgkDdiSubmitCommand