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

# SetShapeEqCompCommand

> SetShapeEqCompCommand

# SetShapeEqCompCommand

Inicializa um comando EQ/Comp do SHAPE.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeEqCompCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 inputMixBuffer,  
         UINT32 sidechainMixBuffer,  
         UINT32 outputMixBuffer  
)  
```

### Parâmetros

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

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

*contextId*   \
Tipo: UINT32

ID do contexto EQ/Comp (índice) que esse comando referenciará.

*inputMixBuffer*   \
Tipo: UINT32

ID do buffer de mixagem de entrada.

*sidechainMixBuffer*   \
Tipo: UINT32

Buffer de mixagem de sidechain. Esse parâmetro é usado apenas para sidechains externos e é ignorado para sidechains normais e internos. Para obter mais informações, confira [SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/pt-BR/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode.md).

*outputMixBuffer*   \
Tipo: UINT32

ID do buffer de mixagem de saída.

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

A finalidade do compressor é limitar a quantidade de faixa dinâmica no sinal. Ele faz isso monitorando o nível de entrada e criando um valor de ganho dinâmico. O valor de ganho é então usado como multiplicador do sinal e o dimensiona adequadamente, dependendo do nível atual do sinal de entrada. Em outras palavras, é um controle automático de volume, que monitora constantemente o sinal de entrada e se ajusta constantemente.

O compressor atua apenas em sinais acima de um limite específico. Se o sinal for menor que o limite, ele passa inalterado. O limite é definido pelo aplicativo como parte dos dados de contexto EQComp. Há um controle programável no contexto para realizar compressão ou expansão.

O compressor altera os dados de som de acordo com um parâmetro de proporção. Ele especifica quanta atenuação deve ser aplicada ao sinal de entrada se ele exceder o limite. A proporção é exatamente isso: a razão entre o nível de entrada e o nível de saída. Com uma proporção de 2:1, cada 2 dB de nível acima do limite resulta em 1 dB de saída do compressor acima do nível do limite. Com uma proporção de 1:1, o compressor fica essencialmente desligado. A proporção é definida pelo aplicativo como parte dos dados de contexto.

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

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

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


## Related topics

- [ShapeFlowGraph](/pt-BR/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeEqCompAttack](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)
- [SetShapeEqCompThreshold](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)
- [SetShapeEqCompRatio](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompratio.md)
- [SetShapeEqCompGain](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)