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

设置侧链(sidechain)模式。

## 语法

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

### 参数

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

指向 `SHAPE_EQCOMP_CONTEXT` 对象的指针。

*mode*   \
类型:[SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode)

`SHAPE_EQCOMP_SIDECHAIN_MODE` 枚举的一个成员。

### 返回值

类型:HRESULT

HRESULT 成功或错误代码。

## 注解

EQ/压缩器-扩展器模块从一个或两个混音缓冲区获取输入:

* 一个输入是要处理的音频信号。
* 第二个输入称为 *侧链*,是用于决定音频压缩行为的可选控制信号。

压缩器-扩展器可在以下三种侧链模式中的任意一种下运行:

* 在 Normal 模式下,来自一个混音缓冲区的单个音频输入被送入均衡器,随后由压缩器处理并输出到混音缓冲区。
* 在 Internal 模式下,输入信号直接送入压缩器的音频输入,并被分流送入均衡器。从均衡器输出后再送入压缩器的侧链输入。
* 在 External 模式下,使用来自两个独立混音缓冲区的两路独立输入信号。输入信号经过均衡器后送入压缩模块的音频输入。侧链输入信号则直接送入压缩器的侧链输入。

有关详细信息,请参阅 [SHAPE 概述](/build/console-features/audio/overviews/shape-overview) 中的 [均衡与压缩](/build/console-features/audio/overviews/shape-overview#ID4ECF)。

## 要求

**头文件:** shapeeqcompcontext.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

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


## Related topics

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