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

Aloca um buffer de mixagem virtual.

## Sintaxe

```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\*

O comando [SHAPE\_FLOWGRAPH\_COMMAND](/pt-BR/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) a ser inicializado.

*virtualId*   \
Tipo: UINT32

ID virtual do buffer de mixagem, de 0 a 8191, inclusive. Cada buffer de mixagem alocado deve ter uma ID virtual exclusiva.

*numIn*   \
Tipo: UINT32

Número de entradas do buffer de mixagem. Esse valor especifica o número de blocos do SHAPE (Scalable Hardware Audio Processing Engine) que gerarão saída para esse buffer de mixagem.

*numOut*   \
Tipo: UINT32

Número de saídas do buffer de mixagem. Esse valor especifica o número de blocos do SHAPE que lerão desse buffer de mixagem.

*attenuation*   \
Tipo: SHAPE\_MIXBUFFER\_ATTENUATION

Um membro da enumeração [SHAPE\_MIXBUFFER\_ATTENUATION](/pt-BR/reference/audio/shapeflowgraph/enums/shape_mixbuffer_attenuation). Esse valor especifica a atenuação em dB aplicada a todas as entradas desse buffer de mixagem.

### Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará `S_OK`. Se um ou mais argumentos forem inválidos, a função retornará `E_INVALIDARG`.

## Comentários

Todos os buffers de mixagem são de canal único (mono) e devem ser alocados antes do uso. Embora haja um total de 128 buffers de mixagem físicos, há 8192 buffers de mixagem virtuais disponíveis. Os buffers de mixagem físicos podem ser reutilizados, mas os buffers de mixagem virtuais não.

A lista de execução usa IDs virtuais para atribuições de buffer de mixagem. Somente quando um comando de alocação é executado é que um buffer de mixagem físico é associado a uma determinada ID virtual. Os comandos subsequentes que usam uma determinada ID virtual serão direcionados ao buffer de mixagem físico alocado. O comando de alocação é despachado do processador SHAPE para o bloco de buffer de mixagem, que executa a associação da ID virtual ao buffer de mixagem físico.

Muitos títulos não implementam flowgraphs diretamente. O [XAudio2](/pt-BR/build/console-features/audio/overviews/xma2-overview) e o middleware de áudio implementam componentes do SHAPE implicitamente. No entanto, construir flowgraphs oferece a maior flexibilidade e acesso aos recursos de aceleração de áudio do console XBOX One.

## Requisitos

**Cabeçalho:** shapeflowgraph.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)

[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

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