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

O contexto Filter/Volume (FLTVOL).

## Sintaxe

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

### Membros

*timestamp*\
Tipo: UINT32

Leitura: carimbo de data/hora da conclusão do processamento do contexto.

*reserved0*\
Tipo: UINT32

Reservado.

*internalSaturate*\
Tipo: UINT32

Leitura: 1 se o FLTVOL estiver saturado; caso contrário, 0.

*mixBufPeakMag*\
Tipo: UINT32

Leitura: magnitude de pico do buffer de mixagem de saída.

*peakMag*\
Tipo: UINT32

Leitura: magnitude de pico da saída.

*delay1*\
Tipo: UINT32

Leitura: atraso passa-banda do filtro, formatado como s1.28.

*headroom*\
Tipo: UINT32

Gravação: headroom de entrada. Um membro da enumeração [SHAPE\_FILTER\_HEADROOM](/pt-BR/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom).

*delay2*\
Tipo: UINT32

Leitura: atraso passa-baixa do filtro, formatado como s1.28.

*svfMode*\
Tipo: UINT32

Gravação: modo do filtro de variável de estado. Um membro da enumeração [SHAPE\_FILTER\_MODE](/pt-BR/reference/audio/shapefiltvolcontext/enums/shape_filter_mode).

*gainTarget*\
Tipo: UINT32

Gravação: destino do ganho de saída, formatado como s1.14.

*gain*\
Tipo: UINT32

Leitura/Gravação: ganho de saída atual, formatado como s1.14.

*qRecip*\
Tipo: UINT32

Leitura/Gravação: recíproco do fator Q (qualidade) atual, formatado como u1.23.

*reserved1*\
Tipo: UINT32

Reservado.

*qRecipTarget*\
Tipo: UINT32

Gravação: recíproco do fator Q (qualidade) de destino, formatado como u1.23.

*reserved2*\
Tipo: UINT32

Reservado.

*fc*\
Tipo: UINT32

Leitura/Gravação: frequência de corte atual, formatada como u.24.

*reserved3*\
Tipo: UINT32

Reservado.

*fcTarget*\
Tipo: UINT32

Gravação: frequência de corte de destino, formatada como u.24.

*reserved3*\
Tipo: UINT32

Reservado.

## Comentários

Essa estrutura contém o contexto para o bloco Filter/Volume (FLTVOL). O SHAPE (Scalable Hardware Audio Processing Engine) pode processar até 2.560 contextos FLTVOL por quadro de áudio. No entanto, o número de contextos endereçáveis na memória é maior para simplificar a reutilização de fluxos.

Os membros marcados como **Leitura** são gravados pela biblioteca do ACP (Audio Control Processor) e devem apenas ser lidos pelo seu aplicativo. Os membros marcados como **Gravação** são definidos pelo seu aplicativo e não são alterados pela biblioteca do ACP. Os membros marcados como **Leitura/Gravação** são definidos pelo seu aplicativo, mas podem ser alterados pela biblioteca do ACP.
Para obter mais informações, confira a seção [Bloco de filtro/volume (FLTVOL)](/pt-BR/build/console-features/audio/overviews/shape-overview#ID4EBH) de [Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview).

## Requisitos

**Cabeçalho:** shapefiltvolcontext.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)

## Confira também

[ShapeFiltVolContext](/pt-BR/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)