> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetShapeEqCompThreshold

> SetShapeEqCompThreshold

# SetShapeEqCompThreshold

コンプレッションのしきい値を設定します。

## Syntax

```cpp theme={null}
HRESULT SetShapeEqCompThreshold(  
         SHAPE_EQCOMP_CONTEXT* context,  
         float threshold  
)  
```

### パラメーター

*context*   \_Inout\_\
型: [SHAPE\_EQCOMP\_CONTEXT\*](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context.md)

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

*threshold*   \
型: float

コンプレッションのしきい値。

### 戻り値

型: HRESULT

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

## 解説

コンプレッサーは、特定のしきい値を超える信号にのみ作用します。しきい値を下回る信号は変更されずに通過します。

コンプレッサーは、入力レベルと出力レベルの比率を指定するパラメーターに従ってサウンド データを変化させます。この比率は、入力信号がしきい値を超えた場合に実行される減衰の程度を表します。(コンプレッサー / エキスパンダー モードが `SHAPE_EQCOMP_EXPAND_MODE_EXPANDER` に設定されている場合、動作は反転します。エキスパンダーは、特定のしきい値を下回る信号に作用し、しきい値を上回る信号は変更されずに通過します。)

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

## 要件

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

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

## 関連項目

[GetShapeEqCompThreshold](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/functions/getshapeeqcompthreshold.md)\
[ShapeEqCompContext](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)


## Related topics

- [GetShapeEqCompThreshold](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/functions/getshapeeqcompthreshold.md)
- [SetShapeEqCompExpandMode](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/functions/setshapeeqcompexpandmode.md)
- [ShapeEqCompContext](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompRelease](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/functions/setshapeeqcomprelease.md)
- [SetShapeEqCompGain](https://docs.xbox.com/ja-jp/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)