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

# SHAPE_FILTVOL_CONTEXT

> SHAPE_FILTVOL_CONTEXT

# SHAPE\_FILTVOL\_CONTEXT

Contexto de filtro/volumen (FLTVOL).

## Sintaxis

```cpp theme={null}
typedef struct SHAPE_FILTVOL_CONTEXT {  
    UINT32 timestamp : 21;
    UINT32 reserved0 : 2;
    UINT32 internalSaturate : 1;
    UINT32 mixBufPeakMag : 4;
    UINT32 peakMag : 4;
    UINT32 delay1 : 30;
    UINT32 headroom : 2;
    UINT32 delay2 : 30;
    UINT32 svfMode : 2;
    UINT32 gainTarget : 16;
    UINT32 gain : 16;
    UINT32 qRecip : 24;
    UINT32 reserved1 : 8;
    UINT32 qRecipTarget : 24;
    UINT32 reserved2 : 8;
    UINT32 fc : 24;
    UINT32 reserved3 : 8;
    UINT32 fcTarget : 24;
    UINT32 reserved4 : 8;
} SHAPE_FILTVOL_CONTEXT  
```

### Miembros

*timestamp*\
Tipo: UINT32

Lectura: marca de tiempo de la finalización del procesamiento del contexto.

*reserved0*\
Tipo: UINT32

Reservado.

*internalSaturate*\
Tipo: UINT32

Lectura: 1 si FLTVOL está saturado; 0 en caso contrario.

*mixBufPeakMag*\
Tipo: UINT32

Lectura: magnitud de pico del búfer de mezcla de salida.

*peakMag*\
Tipo: UINT32

Lectura: magnitud de pico de la salida.

*delay1*\
Tipo: UINT32

Lectura: retardo de paso de banda para el filtro, con formato s1.28.

*headroom*\
Tipo: UINT32

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

*delay2*\
Tipo: UINT32

Lectura: retardo de paso bajo para el filtro, con formato s1.28.

*svfMode*\
Tipo: UINT32

Escritura: modo del filtro de variable de estado. Un miembro de la enumeración [SHAPE\_FILTER\_MODE](/reference/audio/shapefiltvolcontext/enums/shape_filter_mode).

*gainTarget*\
Tipo: UINT32

Escritura: objetivo de la ganancia de salida, con formato s1.14.

*gain*\
Tipo: UINT32

Lectura/Escritura: ganancia de salida actual, con formato s1.14.

*qRecip*\
Tipo: UINT32

Lectura/Escritura: recíproco del factor Q (calidad) actual, con formato u1.23.

*reserved1*\
Tipo: UINT32

Reservado.

*qRecipTarget*\
Tipo: UINT32

Escritura: recíproco del factor Q (calidad) objetivo, con formato u1.23.

*reserved2*\
Tipo: UINT32

Reservado.

*fc*\
Tipo: UINT32

Lectura/Escritura: frecuencia de esquina actual, con formato u.24.

*reserved3*\
Tipo: UINT32

Reservado.

*fcTarget*\
Tipo: UINT32

Escritura: frecuencia de esquina objetivo, con formato u.24.

*reserved3*\
Tipo: UINT32

Reservado.

## Comentarios

Esta estructura contiene el contexto del bloque de filtro/volumen (FLTVOL). El motor de procesamiento de audio por hardware escalable (SHAPE) puede procesar hasta 2560 contextos FLTVOL por fotograma de audio. Sin embargo, el número de contextos direccionables en memoria es mayor para simplificar la reutilización de secuencias.

Los miembros marcados como **Lectura** los escribe la biblioteca del procesador de control de audio (ACP) y la aplicación solo debe leerlos. Los miembros marcados como **Escritura** los establece la aplicación y la biblioteca del ACP no los cambia. Los miembros marcados como **Lectura/Escritura** los establece la aplicación, pero la biblioteca del ACP puede cambiarlos.
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

## Documentación conceptual

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

## Consulte también

[ShapeFiltVolContext](/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members)


## Related topics

- [ShapeFiltVolContext](/es/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [ACP_COMMAND_UPDATE_FILTVOL_CONTEXT_ENTRY](/es/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry.md)
- [GetShapeFiltVolQ](/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvolq.md)
- [SetShapeFiltVolQ](/es/reference/audio/shapefiltvolcontext/functions/setshapefiltvolq.md)
- [GetShapeFiltVolQTarget](/es/reference/audio/shapefiltvolcontext/functions/getshapefiltvolqtarget.md)