Pular para o conteúdo principal

​
SetShapeAllocMixBufferCommand

Aloca um buffer de mixagem virtual.

​
Sintaxe

​
Parâmetros

command   _Inout_
Tipo: SHAPE_FLOWGRAPH_COMMAND* O comando 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. 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 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 Visão geral do SHAPE shapeflowgraph
Última modificação em 6 de outubro de 2026

Tópicos relacionados

SHAPE_FLOWGRAPH_COMMAND_TYPEShapeFlowGraphSHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMANDSHAPE_FLOWGRAPH_COMMANDSetShapeEqCompCommand