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

# Fonction SetShapeSrcCommand

> Fonction SetShapeSrcCommand

# Fonction SetShapeSrcCommand

Initialise une commande SRC SHAPE.

## Syntaxe

```cpp theme={null}
HRESULT SetShapeSrcCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 leftorMonoMixBuffer,  
         UINT32 rightMixBuffer  
)  
```

### Paramètres

*command*   \_Inout\_\
Type : SHAPE\_FLOWGRAPH\_COMMAND\*

Commande [SHAPE\_FLOWGRAPH\_COMMAND](/fr-CA/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) à initialiser.

*contextId*   \
Type : UINT32

ID (index) du contexte SRC auquel cette commande fera référence.

*leftorMonoMixBuffer*   \
Type : UINT32

ID du tampon de mixage d'entrée.

*rightMixBuffer*   \
Type : UINT32

ID du tampon de mixage de sortie.

### Valeur de retour

Type : HRESULT

Si la fonction réussit, elle retourne `S_OK`. Si un ou plusieurs des arguments ne sont pas valides, la fonction retourne `E_INVALIDARG`.

## Remarques

Vous pouvez soumettre des graphes de flux à traiter de façon persistante ou non persistante. Les graphes de flux persistants sont traités, puis restent résidents pour répéter leur traitement dans la trame suivante, une fois que les pointeurs de lecture et d'écriture ont avancé et que les autres informations de contexte ont été mises à jour. Vous pouvez utiliser des graphes de flux persistants pour l'un ou l'autre des scénarios suivants.

* **Graphes de flux très complexes** qui nécessitent une quantité importante de traitement processeur pour réassembler chaque trame.
* **Graphes de flux très statiques** comportant le même nombre et la même configuration de voix pendant une période prolongée.

Utilisez des graphes de flux non persistants pour l'un des scénarios suivants.

* Les topologies de voix changent fréquemment.
* La cadence de traitement du moteur audio logiciel de votre titre est dissociée du matériel SHAPE et n'est pas un multiple de 2,667 ms.
* Vous souhaitez exécuter le traitement audio plus rapidement qu'en temps réel, en soumettant des graphes à consommer dès qu'ils sont disponibles.

De nombreux titres n'implémentent pas directement de graphes de flux. [XAudio2](/fr-CA/build/console-features/audio/overviews/xaudio2-overview) et les intergiciels audio implémentent implicitement les composants SHAPE. Cependant, la construction de graphes de flux offre la plus grande flexibilité et le meilleur accès aux capacités d'accélération audio de la console XBOX One.

## Configuration requise

**En-tête :** shapeflowgraph.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/fr-CA/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SetShapeSrcCommand](/reference/audio/shapesrccontext/functions/shapesrccontext_setshapesrccommand.md)
- [SetShapeSrcCommand function](/reference/audio/shapeflowgraph/functions/shapeflowgraph_setshapesrccommand.md)
- [SetShapeSrcCommand 函数](/zh-CN/reference/audio/shapeflowgraph/functions/shapeflowgraph_setshapesrccommand.md)
- [Función SetShapeSrcCommand](/es/reference/audio/shapeflowgraph/functions/shapeflowgraph_setshapesrccommand.md)