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

Filter/Volume(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

이 구조체는 Filter/Volume(FLTVOL) 블록의 컨텍스트를 포함합니다. Scalable Hardware Audio Processing Engine(SHAPE)은 오디오 프레임당 최대 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](/ko/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [ACP_COMMAND_UPDATE_FILTVOL_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_filtvol_context_entry.md)
- [GetShapeFiltVolQ](/ko/reference/audio/shapefiltvolcontext/functions/getshapefiltvolq.md)
- [GetShapeFiltVolMode](/ko/reference/audio/shapefiltvolcontext/functions/getshapefiltvolmode.md)
- [GetShapeFiltVolQTarget](/ko/reference/audio/shapefiltvolcontext/functions/getshapefiltvolqtarget.md)