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

Establece el modo de cadena lateral.

## Sintaxis

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

### Parámetros

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

Puntero a un objeto `SHAPE_EQCOMP_CONTEXT`.

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

Un miembro de la enumeración `SHAPE_EQCOMP_SIDECHAIN_MODE`.

### Valor devuelto

Tipo: HRESULT

Código HRESULT de éxito o de error.

## Comentarios

El bloque EQ/compresor-expansor toma la entrada de uno o dos búferes de mezcla:

* Una entrada es la señal de audio que se va a procesar.
* La segunda entrada, denominada *cadena lateral* (sidechain), es la señal de control opcional que se usa para determinar la compresión de audio.

El compresor-expansor puede funcionar en uno de tres modos de cadena lateral:

* En el modo Normal, una única entrada de audio procedente de un búfer de mezcla pasa por el ecualizador, donde posteriormente la procesa el compresor y se envía a un búfer de mezcla.
* En el modo Interno, la señal de entrada se envía directamente a la entrada de audio del compresor, y se divide y se envía al ecualizador. Desde el ecualizador, se envía a la entrada de cadena lateral del compresor.
* En el modo Externo, se usan dos señales de entrada independientes procedentes de dos búferes de mezcla distintos. La señal de entrada pasa por el ecualizador y llega a la entrada de audio del bloque de compresión. La señal de entrada de cadena lateral se envía directamente a la entrada de cadena lateral del compresor.

Para obtener más información, consulte [Ecualización y compresión](/build/console-features/audio/overviews/shape-overview#ID4ECF) en [Información general de SHAPE](/build/console-features/audio/overviews/shape-overview).

## Requisitos

**Encabezado:** shapeeqcompcontext.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

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