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

# SetShapeEqCompThreshold

> SetShapeEqCompThreshold

# SetShapeEqCompThreshold

Define o limite de compressão.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeEqCompThreshold(  
         SHAPE_EQCOMP_CONTEXT* context,  
         float threshold  
)  
```

### Parâmetros

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

Ponteiro para um objeto `SHAPE_EQCOMP_CONTEXT`.

*threshold*   \
Tipo: float

O valor do limite de compressão.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

O compressor atua somente em sinais que excedem um limite específico; os sinais abaixo do limite passam sem alteração.

O compressor altera os dados de som de acordo com um parâmetro que especifica a razão entre o nível de entrada e o nível de saída. A razão representa a extensão da atenuação a ser aplicada ao sinal de entrada se ele exceder o limite. (Se o modo de compressor/expansor estiver definido como `SHAPE_EQCOMP_EXPAND_MODE_EXPANDER`, o comportamento será invertido. O expansor atua em sinais abaixo de um limite específico; os sinais acima do limite passam sem alteração.)

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

[GetShapeEqCompThreshold](/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompthreshold)\
[ShapeEqCompContext](/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)


## Related topics

- [GetShapeEqCompThreshold](/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompthreshold.md)
- [SetShapeEqCompExpandMode](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompexpandmode.md)
- [ShapeEqCompContext](/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompAttack](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)
- [SetShapeEqCompGain](/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)