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

# SetShapeAllocMixBufferCommand

> SetShapeAllocMixBufferCommand

# SetShapeAllocMixBufferCommand

Alloue un tampon de mixage virtuel.

## Syntaxe

```cpp theme={null}
HRESULT SetShapeAllocMixBufferCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 virtualId,  
         UINT32 numIn,  
         UINT32 numOut,  
         SHAPE_MIXBUFFER_ATTENUATION attenuation  
)  
```

### Paramètres

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

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

*virtualId*   \
Type : UINT32

ID virtuel du tampon de mixage, de 0 à 8191 inclusivement. Chaque tampon de mixage alloué doit avoir un ID virtuel unique.

*numIn*   \
Type : UINT32

Nombre d'entrées du tampon de mixage. Cette valeur spécifie le nombre de blocs du moteur de traitement audio matériel évolutif (SHAPE) qui écriront leur sortie dans ce tampon de mixage.

*numOut*   \
Type : UINT32

Nombre de sorties du tampon de mixage. Cette valeur spécifie le nombre de blocs SHAPE qui liront à partir de ce tampon de mixage.

*attenuation*   \
Type : SHAPE\_MIXBUFFER\_ATTENUATION

Un membre de l'énumération [SHAPE\_MIXBUFFER\_ATTENUATION](/fr-CA/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation). Cette valeur spécifie l'atténuation en dB appliquée à toutes les entrées de ce tampon de mixage.

### Valeur de retour

Type : HRESULT

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

## Remarques

Tous les tampons de mixage sont à canal unique (mono) et doivent être alloués avant leur utilisation. Bien qu'il y ait au total 128 tampons de mixage physiques, 8192 tampons de mixage virtuels sont disponibles. Les tampons de mixage physiques peuvent être réutilisés, mais pas les tampons de mixage virtuels.

La liste d'exécution utilise des ID virtuels pour les affectations de tampons de mixage. Ce n'est que lorsqu'une commande d'allocation est exécutée qu'un tampon de mixage physique est lié à un ID virtuel donné. Les commandes subséquentes qui utilisent un ID virtuel donné seront dirigées vers le tampon de mixage physique alloué. La commande d'allocation est envoyée par le processeur SHAPE au bloc de tampons de mixage, qui effectue la liaison entre l'ID virtuel et le tampon de mixage physique.

De nombreux titres n'implémentent pas directement de graphes de flux. [XAudio2](/fr-CA/build/console-features/audio/overviews/xma2-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 l'ACP](/fr-CA/build/console-features/audio/overviews/acp-overview)

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

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


## Related topics

- [SetShapeAllocMixBufferCommand](/reference/audio/shapeflowgraph/functions/setshapeallocmixbuffercommand.md)
- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [ShapeFlowGraph](/reference/audio/shapeflowgraph/shapeflowgraph_members.md)