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

# SetShapeEqCompGainTarget

> SetShapeEqCompGainTarget

# SetShapeEqCompGainTarget

Définit la cible du gain de sortie (gain de compensation) du compresseur.

## Syntaxe

```cpp theme={null}
HRESULT SetShapeEqCompGainTarget(  
         SHAPE_EQCOMP_CONTEXT* context,  
         float gainTarget  
)  
```

### Paramètres

*context*   \_Inout\_
Type : [SHAPE\_EQCOMP\_CONTEXT\*](/fr-CA/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context)

Pointeur vers un objet `SHAPE_EQCOMP_CONTEXT`.

*gainTarget*   
Type : float

La cible de gain.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Le compresseur limite la plage dynamique du signal en surveillant le niveau d'entrée et en créant une valeur de gain dynamique. Le compresseur utilise ensuite cette valeur de gain comme multiplicateur du signal, afin de le mettre à l'échelle de façon appropriée en fonction du niveau actuel du signal d'entrée. Autrement dit, le compresseur est un contrôle automatique du volume qui surveille constamment le signal d'entrée et s'ajuste en conséquence.

Pour plus d'informations, consultez [Égalisation et compression](/fr-CA/build/console-features/audio/overviews/shape-overview#ID4ECF) dans [Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview).

## Configuration requise

**En-tête :** shapeeqcompcontext.h

**Plateformes prises en charge :** Consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[GetShapeEqCompGainTarget](/fr-CA/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgaintarget)\
[ShapeEqCompContext](/fr-CA/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)


## Related topics

- [SetShapeEqCompGainTarget](/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgaintarget.md)
- [GetShapeEqCompGainTarget](/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgaintarget.md)
- [ShapeEqCompContext](/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompFilterTargetCoefficients](/reference/audio/shapeeqcompcontext/functions/setshapeeqcompfiltertargetcoefficients.md)
- [SetShapeEqCompRawFilterTargetCoefficients](/reference/audio/shapeeqcompcontext/functions/setshapeeqcomprawfiltertargetcoefficients.md)