D3D12XBOX_DISPATCH_FLAGS (XBOX Series 主機)

用於控制 ID3D12GraphicsCommandList.DispatchX 的旗標。

語法

typedef enum D3D12XBOX_DISPATCH_FLAGS  : UINT  
{  
    D3D12XBOX_DISPATCH_FLAG_NONE = 0x00000000,  
    D3D12XBOX_DISPATCH_FLAG_FORCE_START_AT_000 = 0x00000004,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND = 0x00000008,  
    D3D12XBOX_DISPATCH_FLAG_ORDERED_APPEND_WAVEID_PER_THREADGROUP = 0x00000010,  
    D3D12XBOX_DISPATCH_FLAG_USE_THREAD_DIMENSIONS = 0x00000020,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER = 0x00000040,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_VECTOR_L1 = 0x00000080,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_SCALAR_L1 = 0x00000200,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_SCALAR_L1 = 0x00000400,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_VECTOR_L1 = 0x00000800,  
    D3D12XBOX_DISPATCH_FLAG_W32 = 0x00008000,  
} D3D12XBOX_DISPATCH_FLAGS  

常數

常數	描述
D3D12XBOX_DISPATCH_FLAG_NONE	無旗標。
D3D12XBOX_DISPATCH_FLAG_FORCE_START_AT_000	若為 0，則採用 COMPUTE_START_X、COMPUTE_START_Y 和 COMPUTE_START_Z 各自的值。若為 1，則覆寫 COMPUTE_START_X、COMPUTE_START_Y 和 COMPUTE_START_Z，並將它們設為 0。
D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND	若為 0，則不支援 Ordered Append。若為 1，則支援 Ordered Append。
D3D12XBOX_DISPATCH_FLAG_ORDERED_APPEND_WAVEID_PER_THREADGROUP	若為 0，則支援每個 wave 的唯一 wave ID。若為 1，則支援每個 ThreadGroup 的唯一 wave ID。
D3D12XBOX_DISPATCH_FLAG_USE_THREAD_DIMENSIONS	若為 1，則將 ThreadGroupCount 參數解譯為每個維度中要分派的執行緒總數。
D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER	若為 0，SPI 中的所有 CS wave 都必須依序啟動。若為 1，SPI 中的 CS wave 可以不依順序啟動。此旗標只能用於非同步佇列 (如需詳細資訊，請參閱備註)
D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_VECTOR_L1	停用 volatile 向量 L1。
D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_SCALAR_L1	停用 volatile 純量 L1。
D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_SCALAR_L1	使所有標記為 volatile 的快取行純量 L1 失效。
D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_VECTOR_L1	使所有標記為 volatile 的快取行向量 L1 失效。
D3D12XBOX_DISPATCH_FLAG_W32	若設定此旗標，則啟用 wave 32 工作負載，否則預設為 wave 64。

備註

D3D12XBOX_DISPATCH_FLAGS 用於控制 ID3D12GraphicsCommandList.DispatchX。
這些列舉常數會以位元 OR 組合的方式傳入。

對於在 wave32 模式下僅包含單一 wave，且只宣告一個執行緒群組維度 (例如 [numthreads(X, 1, 1)]) 的執行緒群組，可以使用 D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER 旗標，在 XBOX Series X 上達到每個時脈週期啟動 2 個 wave、在 XBOX Series S 上達到每個時脈週期啟動 1 個 wave 的啟動速率。如需詳細資訊，請參閱 GpuBench 範例的 “LaunchRate(ACS)” 基準測試。
只有在繫結的計算著色器是以 -D__XBOX_ENABLE_WAVE32=1 編譯時，才必須設定 D3D12XBOX_DISPATCH_FLAG_W32 旗標 (請參閱 XBOX 著色器編譯器定義

如需 ID3D12GraphicsCommandList::DispatchX 方法之一般 Direct3d 12 版本的詳細資訊，請參閱 Dispatch。

需求

標頭： d3d12_xs.h 支援的平台： XBOX Series 主機

另請參閱

d3d12_xs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

語法

常數

備註

需求

另請參閱

​語法

​常數

​備註

​需求

​另請參閱

語法

常數

備註

需求

另請參閱