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

# SetShapeEqCompCommand

> SetShapeEqCompCommand

# SetShapeEqCompCommand

Inicializa un comando EQ/Comp de SHAPE.

## Sintaxis

```cpp theme={null}
HRESULT SetShapeEqCompCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 inputMixBuffer,  
         UINT32 sidechainMixBuffer,  
         UINT32 outputMixBuffer  
)  
```

### Parámetros

*command*   \_Inout\_\
Tipo: SHAPE\_FLOWGRAPH\_COMMAND\*

Comando [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) que se va a inicializar.

*contextId*   \
Tipo: UINT32

Identificador (índice) del contexto EQ/Comp al que hará referencia este comando.

*inputMixBuffer*   \
Tipo: UINT32

Identificador del búfer de mezcla de entrada.

*sidechainMixBuffer*   \
Tipo: UINT32

Búfer de mezcla de sidechain. Este parámetro se usa solo para sidechains externos y se omite para sidechains normales e internos. Para obtener más información, consulte [SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode).

*outputMixBuffer*   \
Tipo: UINT32

Identificador del búfer de mezcla de salida.

### Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, devuelve `S_OK`. Si uno o varios argumentos no son válidos, la función devuelve `E_INVALIDARG`.

## Comentarios

El propósito del compresor es limitar la cantidad de intervalo dinámico de la señal. Para ello, supervisa el nivel de entrada y crea un valor de ganancia dinámico. El valor de ganancia se usa entonces como multiplicador de la señal y la escala apropiadamente en función del nivel actual de la señal de entrada. En otras palabras, es un control de volumen automático, que supervisa constantemente la señal de entrada y se ajusta constantemente.

El compresor actúa solo sobre señales por encima de un umbral específico. Si la señal es menor que el umbral, la señal pasa sin alteraciones. El umbral lo establece la aplicación como parte de los datos de contexto de EQComp. En el contexto hay un control programable para realizar compresión o expansión.

El compresor altera los datos de sonido según un parámetro de relación. Este especifica cuánta atenuación se debe aplicar a la señal entrante si supera el umbral. La relación es exactamente eso: la relación entre el nivel entrante y el nivel saliente. Con una relación de 2:1, cada 2 dB de nivel por encima del umbral producen 1 dB de salida del compresor por encima del nivel de umbral. Con una relación de 1:1, el compresor está esencialmente desactivado. La relación la establece la aplicación como parte de los datos de contexto.

## Requisitos

**Encabezado:** shapeflowgraph.h

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

## Consulte también

[Información general sobre ACP](/build/console-features/audio/overviews/acp-overview)

[Información general de SHAPE](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [ShapeFlowGraph](/es/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeEqCompThreshold](/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompthreshold.md)
- [SetShapeEqCompAttack](/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompattack.md)
- [SetShapeEqCompGain](/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompgain.md)
- [SetShapeEqCompRatio](/es/reference/audio/shapeeqcompcontext/functions/setshapeeqcompratio.md)