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

# SetShapeEqCompRatio

> SetShapeEqCompRatio

# SetShapeEqCompRatio

컴프레션 비율을 설정합니다.

## Syntax

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

### Parameters

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

SHAPE\_EQCOMP\_CONTEXT 객체에 대한 포인터입니다.

*ratio*   \
Type: float

컴프레션 비율입니다.

### Return value

Type: HRESULT

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

## Remarks

컴프레서는 입력 레벨과 출력 레벨의 비율에 따라 사운드 데이터를 변경합니다. 이 비율은 입력 신호가 임계값을 초과할 때 얼마만큼의 감쇠를 수행할지를 결정합니다. 예를 들어, 2:1 비율에서는 임계값을 초과하는 입력 레벨이 2 dB 증가할 때마다 컴프레서에서 임계값을 초과하는 출력이 1 dB로 나옵니다. 1:1 비율에서는 컴프레서가 사실상 꺼진 상태입니다.

자세한 내용은 [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

[ShapeEqCompContext](/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)