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

# SetShapeEqCompSidechainMode

> SetShapeEqCompSidechainMode

# SetShapeEqCompSidechainMode

設定側鏈模式。

## 語法

```cpp theme={null}
HRESULT SetShapeEqCompSidechainMode(  
         SHAPE_EQCOMP_CONTEXT* context,  
         SHAPE_EQCOMP_SIDECHAIN_MODE mode  
)  
```

### 參數

*context*   \_Inout\_\
類型：[SHAPE\_EQCOMP\_CONTEXT\*](/zh-TW/reference/audio/shapeeqcompcontext/structs/shape_eqcomp_context)

指向 `SHAPE_EQCOMP_CONTEXT` 物件的指標。

*mode*   \
類型：[SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/zh-TW/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode)

`SHAPE_EQCOMP_SIDECHAIN_MODE` 列舉的成員。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

EQ/壓縮器-擴展器區塊會從一或兩個混音緩衝區取得輸入：

* 一個輸入是要處理的音訊訊號。
* 第二個輸入稱為「*側鏈*」，是用來決定音訊壓縮的選用控制訊號。

壓縮器-擴展器可在下列三種側鏈模式之一運作：

* 在 Normal 模式中，來自混音緩衝區的單一音訊輸入會送入等化器，接著由壓縮器處理，再輸出至混音緩衝區。
* 在 Internal 模式中，輸入訊號會直接送入壓縮器的音訊輸入，同時被分流並傳送至等化器。訊號從等化器傳送至壓縮器的側鏈輸入。
* 在 External 模式中，會使用來自兩個不同混音緩衝區的兩個不同輸入訊號。輸入訊號會送入等化器，再進入壓縮區塊的音訊輸入。側鏈輸入訊號則直接送入壓縮器的側鏈輸入。

如需詳細資訊，請參閱 [SHAPE 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)中的[等化與壓縮](/zh-TW/build/console-features/audio/overviews/shape-overview#ID4ECF)。

## 需求

**標頭：** shapeeqcompcontext.h

**支援的平台：** XBOX One 系列主機與 XBOX Series 主機

## 另請參閱

[GetShapeEqCompSidechainMode](/zh-TW/reference/audio/shapeeqcompcontext/functions/getshapeeqcompsidechainmode)\
[ShapeEqCompContext](/zh-TW/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members)


## Related topics

- [GetShapeEqCompSidechainMode](/zh-TW/reference/audio/shapeeqcompcontext/functions/getshapeeqcompsidechainmode.md)
- [SHAPE_EQCOMP_SIDECHAIN_MODE](/zh-TW/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode.md)
- [ShapeEqCompContext](/zh-TW/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)
- [SetShapeEqCompCommand](/zh-TW/reference/audio/shapeflowgraph/functions/setshapeeqcompcommand.md)
- [SetShapeEqCompCompressorMode](/zh-TW/reference/audio/shapeeqcompcontext/functions/setshapeeqcompcompressormode.md)