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

# D3D12XBOX_DISPATCH_FLAGS (consoles XBOX Series)

> D3D12XBOX_DISPATCH_FLAGS (consoles XBOX Series) — Sinalizadores para controlar ID3D12GraphicsCommandList.DispatchX. Referência gráfica do Direct3D 12 para XBOX.

Sinalizadores para controlar [ID3D12GraphicsCommandList.DispatchX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx).

## Sintaxe

```cpp theme={null}
typedef enum D3D12XBOX_DISPATCH_FLAGS  : UINT  
{  
    D3D12XBOX_DISPATCH_FLAG_NONE = 0x00000000,  
    D3D12XBOX_DISPATCH_FLAG_FORCE_START_AT_000 = 0x00000004,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND = 0x00000008,  
    D3D12XBOX_DISPATCH_FLAG_ORDERED_APPEND_WAVEID_PER_THREADGROUP = 0x00000010,  
    D3D12XBOX_DISPATCH_FLAG_USE_THREAD_DIMENSIONS = 0x00000020,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER = 0x00000040,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_VECTOR_L1 = 0x00000080,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_SCALAR_L1 = 0x00000200,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_SCALAR_L1 = 0x00000400,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_VECTOR_L1 = 0x00000800,  
    D3D12XBOX_DISPATCH_FLAG_W32 = 0x00008000,  
} D3D12XBOX_DISPATCH_FLAGS  
```

## Constantes

| Constante | Descrição |
| - | - |
| D3D12XBOX\_DISPATCH\_FLAG\_NONE | Nenhum sinalizador. |
| D3D12XBOX\_DISPATCH\_FLAG\_FORCE\_START\_AT\_000 | Se 0, respeita cada um de COMPUTE\_START\_X, COMPUTE\_START\_Y e COMPUTE\_START\_Z. Se 1, substitui cada um de COMPUTE\_START\_X, COMPUTE\_START\_Y e COMPUTE\_START\_Z e os define como 0. |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_ORDERED\_APPEND | Se 0, não oferece suporte a Ordered Append. Se 1, oferece suporte a Ordered Append. |
| D3D12XBOX\_DISPATCH\_FLAG\_ORDERED\_APPEND\_WAVEID\_PER\_THREADGROUP | Se 0, oferece suporte à ID de wave exclusiva por wave. Se 1, oferece suporte à ID de wave exclusiva por ThreadGroup. |
| D3D12XBOX\_DISPATCH\_FLAG\_USE\_THREAD\_DIMENSIONS | Se 1, interpreta os parâmetros *ThreadGroupCount* como as contagens totais de threads a serem despachadas em cada dimensão. |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_OUT\_OF\_ORDER | Se 0, todas as waves de CS no SPI devem ser iniciadas em ordem. Se 1, as waves de CS no SPI podem ser iniciadas fora de ordem. Esse sinalizador deve ser usado apenas em filas assíncronas (consulte [Comentários](#remarks) para obter detalhes) |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_VECTOR\_L1 | Desabilita o L1 vetorial volátil. |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_SCALAR\_L1 | Desabilita o L1 escalar volátil. |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_SCALAR\_L1 | Invalida todas as linhas de cache marcadas como voláteis do L1 escalar. |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_VECTOR\_L1 | Invalida todas as linhas de cache marcadas como voláteis do L1 vetorial. |
| D3D12XBOX\_DISPATCH\_FLAG\_W32 | Se definido, habilita cargas de trabalho wave 32; caso contrário, o padrão é wave 64. |

## Comentários

`D3D12XBOX_DISPATCH_FLAGS` são usados para controlar [ID3D12GraphicsCommandList.DispatchX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx).<br />Essas constantes de enumeração são passadas como uma combinação com OR bit a bit.

* O sinalizador `D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER` pode ser usado para atingir a taxa de inicialização de 2 waves no XBOX Series X e 1 wave no XBOX Series S por ciclo de clock para grupos de threads que contêm uma única wave no modo wave32 e declarados com apenas uma dimensão de grupo de threads, por exemplo `[numthreads(X, 1, 1)]`. Consulte o benchmark *"LaunchRate(ACS)"* do exemplo [**GpuBench**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/samples/gdk-console-samples) para obter mais detalhes.
* O sinalizador `D3D12XBOX_DISPATCH_FLAG_W32` deve ser definido somente quando o sombreador de computação associado tiver sido compilado com `-D__XBOX_ENABLE_WAVE32=1` (consulte [**Definições do compilador de sombreador do XBOX**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/shadercompiler/dxc-xbox-defines)

Para obter mais informações sobre a versão genérica do Direct3D 12 do método `ID3D12GraphicsCommandList::DispatchX`, consulte [Dispatch](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12graphicscommandlist-dispatch).

## Requisitos

**Cabeçalho:** d3d12\_xs.h **Plataformas compatíveis**: consoles XBOX Series

## Confira também

[d3d12\_xs](/pt-BR/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [D3D12_DISPATCH_RAYS_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_EXPORT_FLAGS (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_export_flags_public.md)
- [D3D12_COMMAND_LIST_FLAGS (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_command_list_flags_public.md)
- [D3D12_RAYTRACING_INSTANCE_FLAGS (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_raytracing_instance_flags_public.md)
- [D3D12_RAYTRACING_GEOMETRY_FLAGS (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/enums/d3d12_raytracing_geometry_flags_public.md)