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

Establece la relación de compresión.

## Sintaxis

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

### Parámetros

*context*   \_Inout\_\
Tipo: [SHAPE\_EQCOMP\_CONTEXT\*](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md)

Puntero a un objeto SHAPE\_EQCOMP\_CONTEXT.

*ratio*   \
Tipo: float

La relación de compresión.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

El compresor modifica los datos de sonido según la relación entre el nivel de entrada y el nivel de salida. La relación determina cuánta atenuación debe aplicarse a la señal entrante cuando supera el umbral. Por ejemplo, con una relación de 2:1, cada 2 dB de nivel por encima del umbral producen 1 dB de salida del compresor por encima del nivel del umbral. Con una relación de 1:1, el compresor está esencialmente desactivado.

Para obtener más información, consulte [Ecualización y compresión](https://docs.xbox.com/es/build/console-features/audio/overviews/shape-overview.md#ID4ECF) en [Información general de SHAPE](https://docs.xbox.com/es/build/console-features/audio/overviews/shape-overview.md).

## Requisitos

**Encabezado:** shapeeqcompcontext.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [ShapeEqCompContext](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [GetShapeEqCompRatio](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/functions/getshapeeqcompratio.md)
- [SetShapeEqCompAttack](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)
- [SetShapeEqCompRelease](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcomprelease.md)
- [SetShapeEqCompThreshold](https://docs.xbox.com/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)