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

Asigna un búfer de mezcla virtual.

## Sintaxis

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

### Parámetros

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

Comando [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) que se va a inicializar.

*virtualId*   \
Tipo: UINT32

Identificador virtual del búfer de mezcla, de 0 a 8191, ambos inclusive. Cada búfer de mezcla asignado debe tener un identificador virtual único.

*numIn*   \
Tipo: UINT32

Número de entradas al búfer de mezcla. Este valor especifica el número de bloques del motor de procesamiento de audio por hardware escalable (SHAPE) que enviarán su salida a este búfer de mezcla.

*numOut*   \
Tipo: UINT32

Número de salidas del búfer de mezcla. Este valor especifica el número de bloques SHAPE que leerán de este búfer de mezcla.

*attenuation*   \
Tipo: SHAPE\_MIXBUFFER\_ATTENUATION

Un miembro de la enumeración [SHAPE\_MIXBUFFER\_ATTENUATION](/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation). Este valor especifica la atenuación en dB que se aplica a todas las entradas de este búfer de mezcla.

### Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve `S_OK`. Si uno o varios argumentos no son válidos, la función devuelve `E_INVALIDARG`.

## Comentarios

Todos los búferes de mezcla son de un solo canal (mono) y deben asignarse antes de su uso. Aunque hay un total de 128 búferes de mezcla físicos, hay 8192 búferes de mezcla virtuales disponibles. Los búferes de mezcla físicos se pueden reutilizar, pero los búferes de mezcla virtuales no.

La lista de ejecución usa identificadores virtuales para las asignaciones de búferes de mezcla. Solo cuando se ejecuta un comando de asignación se enlaza un búfer de mezcla físico a un identificador virtual determinado. Los comandos posteriores que usen un identificador virtual determinado se dirigirán al búfer de mezcla físico asignado. El comando de asignación se envía desde el procesador SHAPE al bloque de búferes de mezcla, que realiza el enlace del identificador virtual al búfer de mezcla físico.

Muchos títulos no implementan grafos de flujo directamente. [XAudio2](/build/console-features/audio/overviews/xma2-overview) y el middleware de audio implementan los componentes de SHAPE de forma implícita. Sin embargo, construir grafos de flujo proporciona la mayor flexibilidad y acceso a las capacidades de aceleración de audio de la consola XBOX One.

## Requisitos

**Encabezado:** shapeflowgraph.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general sobre ACP](/build/console-features/audio/overviews/acp-overview)

[Información general de SHAPE](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/es/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)
- [ShapeFlowGraph](/es/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND](/es/reference/audio/shapeflowgraph/structs/shape_flowgraph_alloc_mixbuffer_command.md)
- [SHAPE_FLOWGRAPH_COMMAND](/es/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SetShapeEqCompCommand](/es/reference/audio/shapeflowgraph/functions/setshapeeqcompcommand.md)