> ## 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) コンテキスト。

## Syntax

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

### Members

*timestamp*\
Type: UINT32

Read: コンテキスト処理の完了時のタイムスタンプ。

*reserved0*\
Type: UINT32

予約済み。

*internalSaturate*\
Type: UINT32

Read: FLTVOL が飽和している場合は 1、そうでない場合は 0。

*mixBufPeakMag*\
Type: UINT32

Read: 出力ミックスバッファーのピーク振幅。

*peakMag*\
Type: UINT32

Read: 出力のピーク振幅。

*delay1*\
Type: UINT32

Read: フィルターのバンドパス遅延。s1.28 形式。

*headroom*\
Type: UINT32

Write: 入力ヘッドルーム。[SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom) 列挙体のメンバー。

*delay2*\
Type: UINT32

Read: フィルターのローパス遅延。s1.28 形式。

*svfMode*\
Type: UINT32

Write: 状態変数フィルターのモード。[SHAPE\_FILTER\_MODE](/reference/audio/shapefiltvolcontext/enums/shape_filter_mode) 列挙体のメンバー。

*gainTarget*\
Type: UINT32

Write: 出力ゲインのターゲット。s1.14 形式。

*gain*\
Type: UINT32

Read/Write: 現在の出力ゲイン。s1.14 形式。

*qRecip*\
Type: UINT32

Read/Write: 現在の Q (クオリティ) ファクターの逆数。u1.23 形式。

*reserved1*\
Type: UINT32

予約済み。

*qRecipTarget*\
Type: UINT32

Write: ターゲット Q (クオリティ) ファクターの逆数。u1.23 形式。

*reserved2*\
Type: UINT32

予約済み。

*fc*\
Type: UINT32

Read/Write: 現在のコーナー周波数。u.24 形式。

*reserved3*\
Type: UINT32

予約済み。

*fcTarget*\
Type: UINT32

Write: ターゲットコーナー周波数。u.24 形式。

*reserved3*\
Type: UINT32

予約済み。

## Remarks

この構造体は、フィルター/ボリューム (FLTVOL) ブロックのコンテキストを保持します。Scalable Hardware Audio Processing Engine (SHAPE) は、1 オーディオフレームあたり最大 2,560 個の FLTVOL コンテキストを処理できます。ただし、ストリームの再利用を簡素化するため、メモリでアドレス指定可能なコンテキスト数はこれより多くなっています。

**Read** としてマークされているメンバーは、Audio Control Processor (ACP) ライブラリによって書き込まれ、アプリケーションからは読み取り専用です。**Write** としてマークされているメンバーはアプリケーションによって設定され、ACP ライブラリによって変更されることはありません。**Read/Write** としてマークされているメンバーはアプリケーションによって設定されますが、ACP ライブラリによって変更される場合があります。
詳細については、[SHAPE の概要](/build/console-features/audio/overviews/shape-overview) の [フィルター/ボリュームブロック (FLTVOL)](/build/console-features/audio/overviews/shape-overview#ID4EBH) セクションを参照してください。

## Requirements

**Header:** shapefiltvolcontext.h

**Supported platforms:** XBOX One ファミリー本体および XBOX Series 本体

## Conceptual documentation

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

## See also

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


## Related topics

- [ShapeFiltVolContext](/ja-jp/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [ACP_COMMAND_UPDATE_FILTVOL_CONTEXT_ENTRY](/ja-jp/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry.md)
- [GetShapeFiltVolQ](/ja-jp/reference/audio/shapefiltvolcontext/functions/getshapefiltvolq.md)
- [GetShapeFiltVolDelay1](/ja-jp/reference/audio/shapefiltvolcontext/functions/getshapefiltvoldelay1.md)
- [GetShapeFiltVolDelay2](/ja-jp/reference/audio/shapefiltvolcontext/functions/getshapefiltvoldelay2.md)