> ## 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 (consoles XBOX Series)

> Inicia os threads de um shader de geração de raios.

Inicia os threads de um shader de geração de raios.

## Sintaxe

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

### Parâmetros

*pDesc \[in]*\
Tipo: const D3D12\_DISPATCH\_RAYS\_DESC \*

Uma descrição do despacho de raios

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Este método pode ser chamado a partir de listas de comandos de gráficos ou de computação e de pacotes.

Um estado de pipeline de raytracing deve estar definido na lista de comandos. Caso contrário, o comportamento desta chamada será indefinido.

Há 3 dimensões passadas para definir o tamanho da grade: largura/altura/profundidade. Essas dimensões são restritas de modo que largura \* altura \* profundidade \<= 2^30. Exceder esse limite produz um comportamento indefinido.
Se qualquer dimensão da grade for 0, nenhum thread será iniciado.

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList4](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [D3D12_DISPATCH_RAYS_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [Dispatch](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatch_public.md)
- [Ray tracing no XBOX Series X|S com XDXR](/pt-BR/build/core-features/graphics/newfeatures/raytracing/index.md)
- [D3D12_RAYTRACING_AABB (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_aabb_public.md)
- [IGameInputDispatcher::Dispatch](/pt-BR/reference/input/gameinput/interfaces/IGameInputDispatcher/methods/igameinputdispatcher_dispatch.md)