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

# SetShapeEqCompRatio

> SetShapeEqCompRatio

# SetShapeEqCompRatio

Define a taxa de compressão.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeEqCompRatio(  
         SHAPE_EQCOMP_CONTEXT* context,  
         float ratio  
)  
```

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_EQCOMP\_CONTEXT\*](/pt-BR/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context)

Ponteiro para um objeto SHAPE\_EQCOMP\_CONTEXT.

*ratio*   \
Tipo: float

A taxa de compressão.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

O compressor altera os dados de som de acordo com a razão entre o nível de entrada e o nível de saída. A razão determina quanta atenuação deve ser aplicada ao sinal de entrada quando ele excede o limite. Por exemplo, com uma razã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 razão de 1:1, o compressor fica essencialmente desligado.

Para obter mais informações, confira [Equalização e compressão](/pt-BR/build/console-features/audio/overviews/shape-overview#ID4ECF) em [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview).

## Requisitos

**Cabeçalho:** shapeeqcompcontext.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[ShapeEqCompContext](/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)


## Related topics

- [ShapeEqCompContext](/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [GetShapeEqCompRatio](/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompratio.md)
- [SetShapeEqCompGain](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)
- [SetShapeEqCompRelease](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcomprelease.md)
- [SetShapeEqCompAttack](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)