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

# SetShapeEqCompSidechainMode

> SetShapeEqCompSidechainMode

# SetShapeEqCompSidechainMode

设置侧链(sidechain)模式。

## 语法

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

### 参数

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

指向 `SHAPE_EQCOMP_CONTEXT` 对象的指针。

*mode*   \
类型:[SHAPE\_EQCOMP\_SIDECHAIN\_MODE](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode.md)

`SHAPE_EQCOMP_SIDECHAIN_MODE` 枚举的一个成员。

### 返回值

类型:HRESULT

HRESULT 成功或错误代码。

## 注解

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

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

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

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

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

## 要求

**头文件:** shapeeqcompcontext.h

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

## 另请参阅

[GetShapeEqCompSidechainMode](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/functions/getshapeeqcompsidechainmode.md)\
[ShapeEqCompContext](https://docs.xbox.com/zh-CN/reference/audio/shapeeqcompcontext/shapeeqcompcontext_members.md)


## Related topics

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