> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md)

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](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md#ID4ECF) em [Visão geral do SHAPE](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md).

## Requisitos

**Cabeçalho:** shapeeqcompcontext.h

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

## Confira também

[ShapeEqCompContext](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)


## Related topics

- [ShapeEqCompContext](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [GetShapeEqCompRatio](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompratio.md)
- [SetShapeEqCompThreshold](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)
- [SetShapeEqCompGain](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)
- [SetShapeEqCompRelease](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcomprelease.md)