> ## 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 une mémoire tampon de mixage virtuelle.

## 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/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) à initialiser.

*virtualId*   \
Type : UINT32

ID virtuel de la mémoire tampon de mixage, compris entre 0 et 8191 inclus. Chaque mémoire tampon de mixage allouée doit avoir un ID virtuel unique.

*numIn*   \
Type : UINT32

Nombre d'entrées de la mémoire tampon de mixage. Cette valeur indique le nombre de blocs SHAPE (Scalable Hardware Audio Processing Engine) qui écriront leur sortie dans cette mémoire tampon de mixage.

*numOut*   \
Type : UINT32

Nombre de sorties de la mémoire tampon de mixage. Cette valeur indique le nombre de blocs SHAPE qui liront depuis cette mémoire tampon de mixage.

*attenuation*   \
Type : SHAPE\_MIXBUFFER\_ATTENUATION

Un membre de l'énumération [SHAPE\_MIXBUFFER\_ATTENUATION](/fr/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation). Cette valeur indique l'atténuation en dB appliquée à toutes les entrées de cette mémoire 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

Toutes les mémoires tampons de mixage sont à canal unique (mono) et doivent être allouées avant utilisation. Bien qu'il existe au total 128 mémoires tampons de mixage physiques, 8192 mémoires tampons de mixage virtuelles sont disponibles. Les mémoires tampons de mixage physiques peuvent être réutilisées, mais pas les mémoires tampons de mixage virtuelles.

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

De nombreux titres n'implémentent pas directement de flowgraphs. [XAudio2](/fr/build/console-features/audio/overviews/xma2-overview) et les intergiciels audio implémentent implicitement les composants SHAPE. Toutefois, la construction de flowgraphs offre la plus grande flexibilité et donne accès aux fonctionnalité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/build/console-features/audio/overviews/acp-overview)

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

[shapeflowgraph](/fr/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)