> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetComputeShaderLaunchParametersX (XBOX Series 主機)

> 選擇性覆寫計算管線狀態物件的啟動參數。

選擇性覆寫計算管線狀態物件的啟動參數。

## 語法

```cpp theme={null}
void SetComputeShaderLaunchParametersX(
         const D3D12XBOX_COMPUTE_SHADER_LAUNCH_PARAMETERS* pLaunchParameters  
)
```

### 參數

*pLaunchParameters*   \_In\_opt\_\
類型：[D3D12XBOX\_COMPUTE\_SHADER\_LAUNCH\_PARAMETERS\*](/zh-TW/reference/graphics/d3d12_xs/structs/d3d12xbox_compute_shader_launch_params)

指向要在管線狀態物件中覆寫之計算著色器啟動參數的指標。

### 傳回值

類型：void

沒有傳回值。

## 備註

用來選擇性覆寫目前所設定計算管線狀態物件之啟動設定中的 LDS 與執行緒群組大小，以及 WGP/CU 模式參數。此函式可讓您以輕量方式變更設定，適用於無法以靜態方式建置計算管線狀態物件所有必要排列的使用案例。

此函式也可以在圖形命令佇列上，搭配 `D3D12XBOX_INDIRECT_ARGUMENT_TYPE_COMPUTE_SHADER_LAUNCH_PARAMETERSX` 引數類型 (請參閱 [D3D12\_INDIRECT\_ARGUMENT\_TYPE](/zh-TW/reference/graphics/d3d12_xs/enums/d3d12_indirect_argument_type_xs)) 用於間接分派。

<Info>
  使用此函式之前，您必須先以計算管線狀態物件呼叫 `SetPipelineState` (或使用對應的 `D3D12XBOX_INDIRECT_ARGUMENT_TYPE_PIPELINE_STATE` 引數以間接方式設定)。參數會保持覆寫狀態，直到您設定新的計算管線狀態物件，或驅動程式執行會重設目前所設定計算管線狀態物件的作業 (例如清除或資源解壓縮) 為止。
</Info>

<Info>
  覆寫執行緒群組大小時，您的著色器無法依賴 `SV_DispatchThreadID` 或 `SV_GroupIndex` 系統值，因為這些值是使用著色器編譯時指定的群組大小 (著色器進入點上的 HLSL `[numthreads(XSize, YSize, ZSize)]` 屬性) 來計算。此限制唯一的例外，是著色器最初編譯為 1D 執行緒群組，且您只變更該維度，此時可以繼續使用 `SV_GroupIndex`。
</Info>

<Info>
  如果您的著色器編譯時的執行緒群組大小小於或等於基礎波大小，著色器編譯器可能會將您對 `GroupMemoryBarrier[WithGroupSync]` 的呼叫最佳化移除。如果符合這些條件，且您打算將群組大小變更為超過單一波，則必須確保著色器以大於單一波的 `numthreads` 群組大小進行編譯，以避免這類最佳化。建議您將著色器中的 `numthreads` 設定為您打算執行的最大群組大小。
</Info>

## 需求

**標頭：** d3d12\_xs.h

**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList6](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## Related topics

- [SetComputeRootShaderResourceView](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootshaderresourceview_public.md)
- [Why Mesh Shaders?](/build/core-features/graphics/newfeatures/ms/ms-why.md)
- [SetPipelineState1 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [D3D12_DISPATCH_ARGUMENTS](/reference/graphics/d3d12/structs/d3d12_dispatch_arguments_public.md)