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

Le contexte Filtre/Volume (FLTVOL).

## Syntaxe

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

### Membres

*timestamp*\
Type : UINT32

Lecture : horodatage de la fin du traitement du contexte.

*reserved0*\
Type : UINT32

Réservé.

*internalSaturate*\
Type : UINT32

Lecture : 1 si FLTVOL est saturé; 0 sinon.

*mixBufPeakMag*\
Type : UINT32

Lecture : amplitude de crête du tampon de mixage de sortie.

*peakMag*\
Type : UINT32

Lecture : amplitude de crête de la sortie.

*delay1*\
Type : UINT32

Lecture : délai passe-bande du filtre, au format s1.28.

*headroom*\
Type : UINT32

Écriture : marge d'entrée. Un membre de l'énumération [SHAPE\_FILTER\_HEADROOM](/fr-CA/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom).

*delay2*\
Type : UINT32

Lecture : délai passe-bas du filtre, au format s1.28.

*svfMode*\
Type : UINT32

Écriture : mode du filtre à variables d'état. Un membre de l'énumération [SHAPE\_FILTER\_MODE](/fr-CA/reference/audio/shapefiltvolcontext/enums/shape_filter_mode).

*gainTarget*\
Type : UINT32

Écriture : cible du gain de sortie, au format s1.14.

*gain*\
Type : UINT32

Lecture/Écriture : gain de sortie actuel, au format s1.14.

*qRecip*\
Type : UINT32

Lecture/Écriture : inverse du facteur Q (qualité) actuel, au format u1.23.

*reserved1*\
Type : UINT32

Réservé.

*qRecipTarget*\
Type : UINT32

Écriture : inverse du facteur Q (qualité) cible, au format u1.23.

*reserved2*\
Type : UINT32

Réservé.

*fc*\
Type : UINT32

Lecture/Écriture : fréquence de coupure actuelle, au format u.24.

*reserved3*\
Type : UINT32

Réservé.

*fcTarget*\
Type : UINT32

Écriture : fréquence de coupure cible, au format u.24.

*reserved3*\
Type : UINT32

Réservé.

## Remarques

Cette structure contient le contexte du bloc Filtre/Volume (FLTVOL). Le moteur de traitement audio matériel évolutif (SHAPE) peut traiter jusqu'à 2 560 contextes FLTVOL par trame audio. Toutefois, le nombre de contextes adressables en mémoire est plus grand afin de simplifier la réutilisation des flux.

Les membres marqués **Lecture** sont écrits par la bibliothèque du processeur de contrôle audio (ACP) et ne devraient être que lus par votre application. Les membres marqués **Écriture** sont définis par votre application et ne sont pas modifiés par la bibliothèque ACP. Les membres marqués **Lecture/Écriture** sont définis par votre application, mais peuvent être modifiés par la bibliothèque ACP.
Pour plus d'information, consultez la section [Bloc filtre/volume (FLTVOL)](/fr-CA/build/console-features/audio/overviews/shape-overview#ID4EBH) de la [Vue d'ensemble de SHAPE](/fr-CA/build/console-features/audio/overviews/shape-overview).

## Configuration requise

**En-tête :** shapefiltvolcontext.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Vue d'ensemble de l'ACP](/fr-CA/build/console-features/audio/overviews/acp-overview)

## Voir aussi

[ShapeFiltVolContext](/fr-CA/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members)


## Related topics

- [SHAPE_FILTVOL_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context.md)
- [ShapeFiltVolContext](/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)