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

# SetShapeFiltVolOutputGainTarget

> SetShapeFiltVolOutputGainTarget

# SetShapeFiltVolOutputGainTarget

Establece el destino de la ganancia de salida.

## Sintaxis

```cpp theme={null}
HRESULT SetShapeFiltVolOutputGainTarget(  
         SHAPE_FILTVOL_CONTEXT* context,  
         float outputGainTarget  
)  
```

### Parámetros

*context*   \_Inout\_\
Tipo: [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md)\*

Puntero a un objeto [SHAPE\_FILTVOL\_CONTEXT](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md).

*outputGainTarget*   \
Tipo: float

El destino de la ganancia de salida.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

El destino de ganancia y la ganancia son valores de amplitud en el intervalo de -2.0 a 2.0; los valores negativos invierten la señal.

| Valores | Descripción |
| :- | :- |
| 1.0 a 2.0 | Amplificación |
| 1.0 | Ganancia unitaria |
| 0.0 a 1.0 | Reducción de ganancia |
| 0.0 | Silencio |
| -1.0 a 0.0 | Reducción de ganancia; señal invertida |
| -1.0 | Ganancia unitaria; señal invertida |
| -2.0 a -1.0 | Amplificación; señal invertida |

Para obtener el destino actual de la ganancia de salida, use [GetShapeFiltVolOutputGainTarget](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvoloutputgaintarget.md).

Para obtener más información, consulte la sección [Bloque de filtro/volumen (FLTVOL)](https://docs.xbox.com/es/build/console-features/audio/overviews/shape-overview.md#ID4EBH) de [Información general de SHAPE](https://docs.xbox.com/es/build/console-features/audio/overviews/shape-overview.md).

## Requisitos

**Encabezado:** shapefiltvolcontext.h

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

## Consulte también

[SetShapeFiltVolOutputGain](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/setshapefiltvoloutputgain.md)\
[ShapeFiltVolContext](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)


## Related topics

- [SetShapeFiltVolOutputGain](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/setshapefiltvoloutputgain.md)
- [GetShapeFiltVolOutputGainTarget](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvoloutputgaintarget.md)
- [ShapeFiltVolContext](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [GetShapeFiltVolOutputGain](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvoloutputgain.md)
- [SetShapeFiltVolQTarget](https://docs.xbox.com/es/reference/audio/shapefiltvolcontext/functions/setshapefiltvolqtarget.md)