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

滤波器/音量(FLTVOL)上下文。

## 语法

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

### 成员

*timestamp*\
类型:UINT32

读:上下文处理完成时的时间戳。

*reserved0*\
类型:UINT32

保留。

*internalSaturate*\
类型:UINT32

读:如果 FLTVOL 发生饱和,则为 1;否则为 0。

*mixBufPeakMag*\
类型:UINT32

读:输出混音缓冲区的峰值幅度。

*peakMag*\
类型:UINT32

读:输出的峰值幅度。

*delay1*\
类型:UINT32

读:滤波器的带通延迟,格式为 s1.28。

*headroom*\
类型:UINT32

写:输入余量。[SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom) 枚举的一个成员。

*delay2*\
类型:UINT32

读:滤波器的低通延迟,格式为 s1.28。

*svfMode*\
类型:UINT32

写:状态变量滤波器的模式。[SHAPE\_FILTER\_MODE](/reference/audio/shapefiltvolcontext/enums/shape_filter_mode) 枚举的一个成员。

*gainTarget*\
类型:UINT32

写:输出增益的目标值,格式为 s1.14。

*gain*\
类型:UINT32

读/写:当前的输出增益,格式为 s1.14。

*qRecip*\
类型:UINT32

读/写:当前 Q(品质)因子的倒数,格式为 u1.23。

*reserved1*\
类型:UINT32

保留。

*qRecipTarget*\
类型:UINT32

写:目标 Q(品质)因子的倒数,格式为 u1.23。

*reserved2*\
类型:UINT32

保留。

*fc*\
类型:UINT32

读/写:当前的转折频率,格式为 u.24。

*reserved3*\
类型:UINT32

保留。

*fcTarget*\
类型:UINT32

写:目标转折频率,格式为 u.24。

*reserved3*\
类型:UINT32

保留。

## 注解

此结构包含滤波器/音量(FLTVOL)模块的上下文。可扩展硬件音频处理引擎(SHAPE)每音频帧最多可处理 2,560 个 FLTVOL 上下文。然而,可在内存中寻址的上下文数量更多,以简化流的重用。

标记为 **读** 的成员由音频控制处理器(ACP)库写入,应用程序应仅对其进行读取。标记为 **写** 的成员由应用程序设置,ACP 库不会更改。标记为 **读/写** 的成员由应用程序设置,但可能被 ACP 库更改。
有关详细信息,请参阅 [SHAPE 概述](/build/console-features/audio/overviews/shape-overview) 的 [滤波器/音量模块 (FLTVOL)](/build/console-features/audio/overviews/shape-overview#ID4EBH) 部分。

## 要求

**头文件:** shapefiltvolcontext.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [ACP 概述](/build/console-features/audio/overviews/acp-overview)

## 另请参阅

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


## Related topics

- [ShapeFiltVolContext](/zh-CN/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [ACP_COMMAND_UPDATE_FILTVOL_CONTEXT_ENTRY](/zh-CN/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry.md)
- [GetShapeFiltVolQ](/zh-CN/reference/audio/shapefiltvolcontext/functions/getshapefiltvolq.md)
- [SetShapeFiltVolQ](/zh-CN/reference/audio/shapefiltvolcontext/functions/setshapefiltvolq.md)
- [GetShapeFiltVolDelay1](/zh-CN/reference/audio/shapefiltvolcontext/functions/getshapefiltvoldelay1.md)