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

컴프레서의 출력(메이크업) 게인 목표값을 설정합니다.

## Syntax

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

### Parameters

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

`SHAPE_EQCOMP_CONTEXT` 객체에 대한 포인터입니다.

*gainTarget*   
Type: float

게인 목표값입니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## Remarks

컴프레서는 입력 레벨을 모니터링하고 동적 게인 값을 생성하여 신호의 다이내믹 레인지를 제한합니다. 그런 다음 컴프레서는 이 게인 값을 신호의 승수로 사용하여 현재 입력 신호 레벨에 따라 신호를 적절히 스케일링합니다. 다시 말해, 컴프레서는 입력 신호를 지속적으로 모니터링하고 스스로 조정하는 자동 볼륨 컨트롤입니다.

자세한 내용은 [SHAPE 개요](/build/console-features/audio/overviews/shape-overview)의 [이퀄라이제이션 및 컴프레션](/build/console-features/audio/overviews/shape-overview#ID4ECF)을 참조하세요.

## Requirements

**Header:** shapeeqcompcontext.h

**Supported platforms:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## See also

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


## Related topics

- [GetShapeEqCompGainTarget](/ko/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgaintarget.md)
- [ShapeEqCompContext](/ko/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompGain](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)
- [SetShapeEqCompLogGain](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcomploggain.md)
- [GetShapeEqCompGain](/ko/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgain.md)