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

# SetShapeEqCompCommand

> SetShapeEqCompCommand

# SetShapeEqCompCommand

SHAPE EQ/Comp 명령을 초기화합니다.

## Syntax

```cpp theme={null}
HRESULT SetShapeEqCompCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 inputMixBuffer,  
         UINT32 sidechainMixBuffer,  
         UINT32 outputMixBuffer  
)  
```

### Parameters

*command*   \_Inout\_\
Type: SHAPE\_FLOWGRAPH\_COMMAND\*

초기화할 [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) 명령입니다.

*contextId*   \
Type: UINT32

이 명령이 참조할 EQ/Comp 컨텍스트 ID(인덱스)입니다.

*inputMixBuffer*   \
Type: UINT32

입력 믹스 버퍼 ID입니다.

*sidechainMixBuffer*   \
Type: UINT32

사이드체인 믹스 버퍼입니다. 이 매개변수는 외부 사이드체인에서만 사용되며, 일반 및 내부 사이드체인의 경우 무시됩니다. 자세한 내용은 [SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode)를 참조하세요.

*outputMixBuffer*   \
Type: UINT32

출력 믹스 버퍼 ID입니다.

### Return value

Type: HRESULT

함수가 성공하면 `S_OK`를 반환합니다. 하나 이상의 인수가 유효하지 않으면 `E_INVALIDARG`를 반환합니다.

## Remarks

컴프레서의 목적은 신호의 다이내믹 레인지 양을 제한하는 것입니다. 이를 위해 입력 레벨을 모니터링하고 동적 게인 값을 만들어냅니다. 이 게인 값은 신호의 승수로 사용되어 현재 입력 신호 레벨에 따라 신호를 적절히 스케일링합니다. 즉, 입력 신호를 지속적으로 모니터링하며 스스로를 조정하는 자동 볼륨 컨트롤입니다.

컴프레서는 특정 임계값을 초과하는 신호에만 작동합니다. 신호가 임계값 미만인 경우 신호는 변경 없이 통과합니다. 임계값은 애플리케이션에서 EQComp 컨텍스트 데이터의 일부로 설정합니다. 컨텍스트에는 컴프레션 또는 익스팬션을 수행할 수 있는 프로그래밍 가능한 제어 기능이 있습니다.

컴프레서는 비율(ratio) 매개변수에 따라 사운드 데이터를 변경합니다. 이는 임계값을 초과할 때 입력 신호에 얼마만큼의 감쇠를 적용해야 하는지 지정합니다. 비율은 말 그대로 입력 레벨과 출력 레벨의 비율입니다. 2:1 비율에서는 임계값 초과분 2dB마다 컴프레서에서 임계값 초과분 1dB의 출력이 나옵니다. 1:1 비율에서는 컴프레서가 사실상 꺼진 상태입니다. 비율은 애플리케이션에서 컨텍스트 데이터의 일부로 설정합니다.

## Requirements

**Header:** shapeflowgraph.h

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

## See also

[ACP 개요](/build/console-features/audio/overviews/acp-overview)

[SHAPE 개요](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [ShapeFlowGraph](/ko/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeEqCompAttack](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)
- [SetShapeEqCompThreshold](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)
- [SetShapeEqCompGain](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)
- [SetShapeEqCompRatio](/ko/reference/audio/shapeeqcompcontext/functions/setshapeeqcompratio.md)