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

# SetShapeEqCompGain

> SetShapeEqCompGain

# SetShapeEqCompGain

コンプレッサーの出力 (メイクアップ) ゲインを設定します。

## Syntax

```cpp theme={null}
HRESULT SetShapeEqCompGain(  
         SHAPE_EQCOMP_CONTEXT* context,  
         float gain  
)  
```

### パラメーター

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

`SHAPE_EQCOMP_CONTEXT` オブジェクトへのポインター。

*gain*   \
型: float

ゲイン乗数。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

コンプレッサーは、入力のレベルを監視して動的なゲイン値を作成することにより、信号のダイナミック レンジを制限します。次に、コンプレッサーはそのゲイン値を信号の乗数として使用し、現在の入力信号のレベルに応じて信号を適切にスケーリングします。つまり、コンプレッサーは入力信号を絶えず監視して自身を調整する、自動ボリューム コントロールです。

詳細については、[SHAPE の概要](/build/console-features/audio/overviews/shape-overview)の[イコライゼーションおよびコンプレッション](/build/console-features/audio/overviews/shape-overview#ID4ECF)を参照してください。

## 要件

**ヘッダー:** shapeeqcompcontext.h

**対応プラットフォーム:** XBOX One ファミリ本体および XBOX Series 本体

## 関連項目

[GetShapeEqCompGain](/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgain)\
[ShapeEqCompContext](/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)


## Related topics

- [GetShapeEqCompGain](/ja-jp/reference/audio/shapeeqcompcontext/functions/getshapeeqcompgain.md)
- [ShapeEqCompContext](/ja-jp/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompGainTarget](/ja-jp/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgaintarget.md)
- [SetShapeEqCompLogGain](/ja-jp/reference/audio/shapeeqcompcontext/functions/setshapeeqcomploggain.md)
- [GetShapeEqCompLogGain](/ja-jp/reference/audio/shapeeqcompcontext/functions/getshapeeqcomploggain.md)