> ## 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](/zh-TW/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom) 列舉的成員。

*delay2*\
類型：UINT32

讀取：濾波器的低通延遲，格式為 s1.28。

*svfMode*\
類型：UINT32

寫入：狀態變數濾波器的模式。[SHAPE\_FILTER\_MODE](/zh-TW/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 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)中的[濾波器/音量區塊 (FLTVOL)](/zh-TW/build/console-features/audio/overviews/shape-overview#ID4EBH) 一節。

## 需求

**標頭：** shapefiltvolcontext.h

**支援的平台：** XBOX One 系列主機與 XBOX Series 主機

## 概念文件

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

## 另請參閱

[ShapeFiltVolContext](/zh-TW/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)