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

> Paramètres de remplacement des réglages de lancement de l'objet d'état de pipeline de calcul.

Réglages remplaçables des paramètres de lancement de l'objet d'état de pipeline de calcul.

## Syntaxe

```cpp theme={null}
typedef struct D3D12XBOX_COMPUTE_SHADER_LAUNCH_PARAMETERS
{
    union
    {
        struct
        {
            UINT Flags          :  7;
            UINT LDSSize        :  9;
            UINT NumThreadZ     : 16;
        };
        UINT Dword0;
    };
    union
    {
        struct
        {
             UINT NumThreadX    : 16;
             UINT NumThreadY    : 16;
        };
        UINT Dword1;
    };
} D3D12XBOX_COMPUTE_SHADER_LAUNCH_PARAMETERS;
```

### Membres

*Flags*\
Type : [D3D12XBOX\_COMPUTE\_SHADER\_LAUNCH\_PARAMETER\_FLAGS](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12xbox_compute_shader_launch_param_flags)

Les indicateurs de contrôle déterminent quelle partie des paramètres de lancement est remplacée.

*LDSSize*\
Type : UINT

Taille LDS remplacée. Cette valeur contrôle la quantité de mémoire LDS allouée pour chaque groupe de threads. La plage valide est de 0 à 128 (l'unité est de 128 DWORD). Les groupes de threads peuvent allouer au maximum 64 Ko, quel que soit le mode CU/WPG.

*NumThreadZ*\
Type : UINT

Nombre de threads dans la dimension Z du groupe. Maximum 2048 (voir les remarques ci-dessous).

*NumThreadX*\
Type : UINT

Nombre de threads dans la dimension X du groupe. Maximum 2048 (voir les remarques ci-dessous).

*NumThreadY*\
Type : UINT

Nombre de threads dans la dimension Y du groupe. Maximum 2048 (voir les remarques ci-dessous).

## Remarques

Cette structure est utilisée dans l'API de liste de commandes [SetComputeShaderLaunchParametersX](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_setcomputeshaderlaunchparametersx) et comme valeur d'argument indirect lors de l'utilisation de l'API au moyen du type d'argument `D3D12XBOX_INDIRECT_ARGUMENT_TYPE_COMPUTE_SHADER_LAUNCH_PARAMETERSX` (voir [D3D12\_INDIRECT\_ARGUMENT\_TYPE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12_indirect_argument_type_xs)) en exécution indirecte.

### Mode WGP et mode CU

<a id="wgp_vs_cu_mode" />

La mémoire partagée de groupe (LDS) peut fonctionner selon deux modes différents sur les consoles XBOX Series. Chaque WGP dispose de 128 Ko de mémoire LDS, qui peut être divisée en deux (mode CU) ou traitée comme une seule mémoire partagée (mode WGP).

En mode CU, chacune des unités de calcul (contenant chacune 2 SIMD) d'un WGP se voit attribuer des vagues appartenant à des groupes de threads différents. Chaque CU a accès à 64 Ko de mémoire LDS au moyen d'un bus dédié, ce qui permet un transfert de données total de 2 \* 128 = 256 octets/cycle d'horloge. Les vagues de chaque CU partagent un pool physique de 256 Ko pour les VGPR.

En mode WPG, les 4 SIMD d'un WGP se voient attribuer des vagues du même groupe de threads. Les 128 Ko de mémoire LDS sont accessibles comme un seul pool, mais l'accès passe par un seul des bus physiques présents, ce qui signifie que le débit de transfert de données est limité à 128 octets/cycle d'horloge. Les vagues partagent un pool physique de 512 Ko pour les VGPR.

### Tailles des groupes de threads

Sur les consoles XBOX Series, la taille maximale d'un groupe de threads est de 32 vagues, quelle que soit la largeur de vague. Cela signifie qu'un nuanceur de calcul compilé en wave-64 (par défaut) prend en charge des tailles de groupe de threads allant jusqu'à 2048 threads (`NumThreadX` \* `NumThreadY` \* `NumThreadZ`), alors que le même nuanceur compilé en wave-32 ne prend en charge que des groupes allant jusqu'à 1024 threads. Vous pouvez activer la compilation wave-32 en définissant la définition `__XBOX_ENABLE_WAVE32` à 1.

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

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)