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

# DispatchMesh (consoles XBOX Series)

> Inicia o Mesh Shader ou o Amplification Shader, se ele estiver presente.

Inicia o Mesh Shader ou o Amplification Shader, se ele estiver presente.

## Sintaxe

```cpp theme={null}
void DispatchMesh(  
         UINT ThreadGroupCountX,  
         UINT ThreadGroupCountY,  
         UINT ThreadGroupCountZ  
)  
```

### Parâmetros

*ThreadGroupCountX*   \_In\_\
Tipo: UINT

Número de grupos de threads do Amplification Shader ou do Mesh Shader a serem iniciados

*ThreadGroupCountY*   \_In\_\
Tipo: UINT

Deve ser 1 no XBOX

*ThreadGroupCountZ*   \_In\_\
Tipo: UINT

Deve ser 1 no XBOX

### Valor retornado

Tipo: void

## Comentários

Devido ao sombreamento de estado da CPU para o PSO desse tipo e à forma como ele usa uma combinação de Compute Shaders e Primitive Shaders, esta API tem atualmente várias limitações, conforme listado abaixo

1. Não pode ser usada em um bundle
2. PSOs com Amplification Shader não podem ser usados em um Execute Indirect (PSOs que usam apenas Mesh Shaders podem ser usados em um Execute Indirect com um tipo de token D3D12XBOX\_INDIRECT\_ARGUMENT\_TYPE\_DISPATCH\_MESH\_X)

## Requisitos

**Cabeçalho:** d3d12\_xs.h

**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList6](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)
[https://microsoft.github.io/DirectX-Specs/d3d/MeshShader.html](https://microsoft.github.io/DirectX-Specs/d3d/MeshShader.html)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [DispatchRays (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_dispatchrays_public.md)
- [D3D12_MESH_SHADER_TIER (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12_xs/enums/d3d12_mesh_shader_tier_xs.md)
- [D3D12_DISPATCH_RAYS_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [Exemplo de culling de meshlets](/pt-BR/build/core-features/graphics/newfeatures/ms/ms-meshlet-culling.md)