> ## 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.

# DispatchRays (XBOX Series 主機)

> 啟動光線產生著色器的執行緒。

啟動光線產生著色器的執行緒。

## 語法

```cpp theme={null}
void DispatchRays(
    const D3D12_DISPATCH_RAYS_DESC  pDesc
)
```

### 參數

*pDesc \[in]*\
類型：const D3D12\_DISPATCH\_RAYS\_DESC \*

光線分派的描述

### 傳回值

類型：void

無。

## 備註

此方法可以從圖形或計算命令清單及套件組合呼叫。

命令清單上必須設定光線追蹤管線狀態，否則此呼叫的行為未定義。

傳入 3 個維度來設定格線大小：寬度/高度/深度。這些維度受到限制，必須符合寬度 \* 高度 \* 深度 \<= 2^30。超過此限制會產生未定義的行為。
如果任何格線維度為 0，則不會啟動任何執行緒。

## 需求

**標頭:** d3d12\_xs.h\
**程式庫:** d3d12\_xs.lib\
**支援的平台**: XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList4](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [D3D12_DISPATCH_RAYS_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [Dispatch](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatch_public.md)
- [BuildRaytracingAccelerationStructure (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [CopyRaytracingAccelerationStructure (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [D3D12_RAYTRACING_AABB (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_aabb_public.md)