> ## 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) — Indicateurs permettant de contrôler ID3D12GraphicsCommandList.DispatchX. Référence graphique Direct3D 12 pour XBOX.

Indicateurs permettant de contrôler [ID3D12GraphicsCommandList.DispatchX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx).

## Syntaxe

```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 | Description |
| - | - |
| D3D12XBOX\_DISPATCH\_FLAG\_NONE | Aucun indicateur. |
| D3D12XBOX\_DISPATCH\_FLAG\_FORCE\_START\_AT\_000 | Si 0, respecte chacune des valeurs COMPUTE\_START\_X, COMPUTE\_START\_Y et COMPUTE\_START\_Z. Si 1, remplace chacune des valeurs COMPUTE\_START\_X, COMPUTE\_START\_Y et COMPUTE\_START\_Z et les définit à 0. |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_ORDERED\_APPEND | Si 0, l'ajout ordonné (Ordered Append) n'est pas pris en charge. Si 1, l'ajout ordonné est pris en charge. |
| D3D12XBOX\_DISPATCH\_FLAG\_ORDERED\_APPEND\_WAVEID\_PER\_THREADGROUP | Si 0, prend en charge l'ID de vague unique par vague. Si 1, prend en charge l'ID de vague unique par groupe de threads (ThreadGroup). |
| D3D12XBOX\_DISPATCH\_FLAG\_USE\_THREAD\_DIMENSIONS | Si 1, interprète les paramètres *ThreadGroupCount* comme le nombre total de threads à distribuer dans chaque dimension. |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_OUT\_OF\_ORDER | Si 0, toutes les vagues CS dans le SPI doivent être lancées dans l'ordre. Si 1, les vagues CS dans le SPI peuvent être lancées dans le désordre. Cet indicateur doit être utilisé uniquement sur les files d'attente asynchrones (consultez la section [Remarques](#remarks) pour plus de détails) |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_VECTOR\_L1 | Désactive le L1 vectoriel volatile. |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_SCALAR\_L1 | Désactive le L1 scalaire volatile. |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_SCALAR\_L1 | Invalide toutes les lignes de cache marquées comme volatiles du L1 scalaire. |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_VECTOR\_L1 | Invalide toutes les lignes de cache marquées comme volatiles du L1 vectoriel. |
| D3D12XBOX\_DISPATCH\_FLAG\_W32 | S'il est défini, active les charges de travail wave 32; sinon, la valeur par défaut est wave 64. |

## Remarques

Les `D3D12XBOX_DISPATCH_FLAGS` sont utilisés pour contrôler [ID3D12GraphicsCommandList.DispatchX](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx).<br />Ces constantes d'énumération sont transmises sous forme de combinaison par OU au niveau du bit.

* L'indicateur `D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER` permet d'atteindre un taux de lancement de 2 vagues sur XBOX Series X et de 1 vague sur XBOX Series S par cycle d'horloge pour les groupes de threads contenant une seule vague en mode wave32 et déclarés avec une seule dimension de groupe de threads, par exemple `[numthreads(X, 1, 1)]`. Pour plus de détails, consultez le banc d'essai *« LaunchRate(ACS) »* de l'exemple [**GpuBench**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/samples/gdk-console-samples).
* L'indicateur `D3D12XBOX_DISPATCH_FLAG_W32` doit être défini uniquement lorsque le nuanceur de calcul lié a été compilé avec `-D__XBOX_ENABLE_WAVE32=1` (consultez [**Définitions du compilateur de nuanceurs XBOX**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/shadercompiler/dxc-xbox-defines)

Pour plus d'informations sur la version générique Direct3d 12 de la méthode `ID3D12GraphicsCommandList::DispatchX`, consultez [Dispatch](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12graphicscommandlist-dispatch).

## Configuration requise

**En-tête :** d3d12\_xs.h **Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[d3d12\_xs](/fr-CA/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

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