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

# SetShapeFiltVolInputHeadroom

> SetShapeFiltVolInputHeadroom

# SetShapeFiltVolInputHeadroom

Establece el margen (headroom) de entrada.

## Sintaxis

```cpp theme={null}
HRESULT SetShapeFiltVolInputHeadroom(  
         SHAPE_FILTVOL_CONTEXT* context,  
         SHAPE_FILTER_HEADROOM inputHeadroom  
)  
```

### Parámetros

*context*   \_Inout\_\
Tipo: [SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context)\*

Puntero a un objeto [SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context).

*inputHeadroom*   \
Tipo: [SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom)

Un miembro de la enumeración [SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom).

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

El filtro de variables de estado, por su naturaleza, puede crear resonancias que hacen que los valores intermedios superen 1.0 (o -1.0). Para mitigar los problemas creados por la saturación de valores intermedios, el bloque FLTVOL tiene una cantidad programable de escalado de margen, que se aplica a la señal entrante y luego se compensa en la salida.

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

## Requisitos

**Encabezado:** shapefiltvolcontext.h

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

## Consulte también

[GetShapeFiltVolInputHeadroom](/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinputheadroom)\
[ShapeFiltVolContext](/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members)


## Related topics

- [GetShapeFiltVolInputHeadroom](/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinputheadroom.md)
- [SHAPE_FILTER_HEADROOM](/es/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom.md)
- [GetShapeFiltVolInternalSaturate](/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinternalsaturate.md)
- [ShapeFiltVolContext](/es/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [SetShapeFiltVolCommand](/es/reference/audio/shapeflowgraph/functions/setshapefiltvolcommand.md)