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

# SetShapeEqCompExpandMode

> SetShapeEqCompExpandMode

# SetShapeEqCompExpandMode

Define o modo de compressão/expansão.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeEqCompExpandMode(  
         SHAPE_EQCOMP_CONTEXT* context,  
         SHAPE_EQCOMP_EXPAND_MODE mode  
)  
```

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

*mode*   \
Tipo: [SHAPE\_EQCOMP\_EXPAND\_MODE](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_expand_mode.md)

Um membro da enumeração `SHAPE_EQCOMP_EXPAND_MODE`.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

Normalmente, o bloco EQ/Compressor-Expansor limita a faixa dinâmica do sinal. O compressor atua somente em sinais que excedem um limite específico; os sinais abaixo do limite passam sem alteração.

Quando o modo está definido como `SHAPE_EQCOMP_EXPAND_MODE_EXPANDER`, o comportamento é 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](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

[GetShapeEqCompExpandMode](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompexpandmode.md)\
[SetShapeEqCompThreshold](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)\
[ShapeEqCompContext](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)


## Related topics

- [GetShapeEqCompExpandMode](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/getshapeeqcompexpandmode.md)
- [ShapeEqCompContext](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompThreshold](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)
- [SetShapeEqCompCompressorMode](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompcompressormode.md)
- [SetShapeEqCompSidechainMode](https://docs.xbox.com/pt-BR/reference/audio/shapeeqcompcontext/functions/setshapeeqcompsidechainmode.md)