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

# SetComputeShaderLaunchParametersX (consoles XBOX Series)

> Remplacement sélectif des paramètres de lancement de l'objet d'état de pipeline de calcul.

Remplacement sélectif des paramètres de lancement de l'objet d'état de pipeline de calcul.

## Syntaxe

```cpp theme={null}
void SetComputeShaderLaunchParametersX(
         const D3D12XBOX_COMPUTE_SHADER_LAUNCH_PARAMETERS* pLaunchParameters  
)
```

### Paramètres

*pLaunchParameters*   \_In\_opt\_\
Type : [D3D12XBOX\_COMPUTE\_SHADER\_LAUNCH\_PARAMETERS\*](/fr-CA/reference/graphics/d3d12_xs/structs/d3d12xbox_compute_shader_launch_params)

Pointeur vers les paramètres de lancement du nuanceur de calcul à remplacer dans l'objet d'état de pipeline.

### Valeur renvoyée

Type : void

Aucune valeur renvoyée.

## Remarques

Permet de remplacer de façon sélective les paramètres de taille du LDS et des groupes de threads ainsi que le mode WGP/CU des paramètres de lancement de l'objet d'état de pipeline de calcul actuellement défini. La fonction permet de modifier les paramètres de façon légère, ce qui convient aux cas d'utilisation où vous ne pouvez pas construire de manière statique toutes les permutations nécessaires des objets d'état de pipeline de calcul.

Cette fonction peut également être utilisée pour les dispatchs indirects au moyen du type d'argument `D3D12XBOX_INDIRECT_ARGUMENT_TYPE_COMPUTE_SHADER_LAUNCH_PARAMETERSX` (consultez [D3D12\_INDIRECT\_ARGUMENT\_TYPE](/fr-CA/reference/graphics/d3d12_xs/enums/d3d12_indirect_argument_type_xs)) sur la file d'attente de commandes graphiques.

<Info>
  Vous devez appeler `SetPipelineState` (ou utiliser l'argument `D3D12XBOX_INDIRECT_ARGUMENT_TYPE_PIPELINE_STATE` correspondant pour le définir indirectement) avec un objet d'état de pipeline de calcul avant d'utiliser cette fonction. Les paramètres restent remplacés jusqu'à ce que vous définissiez un nouvel objet d'état de pipeline de calcul ou que le pilote effectue une opération (comme un effacement ou une décompression de ressource) qui réinitialise par ailleurs l'objet d'état de pipeline de calcul actuellement défini.
</Info>

<Info>
  Lorsque vous remplacez la taille des groupes de threads, votre nuanceur ne peut pas se fier aux valeurs système `SV_DispatchThreadID` ou `SV_GroupIndex`, car elles sont calculées à l'aide de la taille de groupe spécifiée au moment de la compilation du nuanceur (attribut HLSL `[numthreads(XSize, YSize, ZSize)]` sur le point d'entrée du nuanceur). La seule exception à cette limitation est lorsque le nuanceur a été compilé à l'origine avec un groupe de threads 1D et que vous modifiez uniquement cette même dimension, ce qui vous permet de continuer à utiliser `SV_GroupIndex`.
</Info>

<Info>
  Si votre nuanceur a été compilé avec une taille de groupe de threads inférieure ou égale à la taille de vague sous-jacente, le compilateur de nuanceurs peut éliminer par optimisation tous les appels que vous faites à `GroupMemoryBarrier[WithGroupSync]`. Si ces conditions s'appliquent et que vous prévoyez modifier la taille de groupe au-delà d'une seule vague, vous devez vous assurer que le nuanceur est compilé avec une taille de groupe `numthreads` supérieure à une seule vague pour empêcher une telle optimisation. Nous vous recommandons de définir `numthreads` dans le nuanceur à la taille de groupe maximale avec laquelle vous prévoyez l'exécuter.
</Info>

## Configuration requise

**En-tête :** d3d12\_xs.h

**Bibliothèque :** d3d12\_xs.lib\
**Plateformes prises en charge** : consoles XBOX Series

## Voir aussi

[ID3D12GraphicsCommandList6](/fr-CA/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/id3d12graphicscommandlist6)


## 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)
- [SetComputeRootShaderResourceView](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootshaderresourceview_public.md)
- [SetPipelineState1 (XBOX Series consoles)](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_setpipelinestate1_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)