> ## 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](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

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