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

# SetShapeFiltVolInputHeadroom

> SetShapeFiltVolInputHeadroom

# SetShapeFiltVolInputHeadroom

입력 헤드룸을 설정합니다.

## Syntax

```cpp theme={null}
HRESULT SetShapeFiltVolInputHeadroom(  
         SHAPE_FILTVOL_CONTEXT* context,  
         SHAPE_FILTER_HEADROOM inputHeadroom  
)  
```

### Parameters

*context*   \_Inout\_\
Type: [SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context)\*

[SHAPE\_FILTVOL\_CONTEXT](/reference/audio/shapefiltvolcontext/structs/shape_filtvol_context) 객체에 대한 포인터입니다.

*inputHeadroom*   \
Type: [SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom)

[SHAPE\_FILTER\_HEADROOM](/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom) 열거형의 멤버입니다.

### Return value

Type: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## Remarks

상태 변수 필터(state variable filter)는 그 특성상 공진을 발생시켜 중간 값이 1.0(또는 -1.0)을 초과할 수 있습니다. 중간 값의 포화로 인한 문제를 완화하기 위해 FLTVOL 블록은 프로그래밍 가능한 헤드룸 스케일링을 제공합니다. 이는 입력 신호에 적용되었다가 출력 시 보정됩니다.

자세한 내용은 [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 콘솔

## See also

[GetShapeFiltVolInputHeadroom](/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinputheadroom)\
[ShapeFiltVolContext](/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members)


## Related topics

- [GetShapeFiltVolInputHeadroom](/ko/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinputheadroom.md)
- [SHAPE_FILTER_HEADROOM](/ko/reference/audio/shapefiltvolcontext/enums/shape_filter_headroom.md)
- [GetShapeFiltVolInternalSaturate](/ko/reference/audio/shapefiltvolcontext/functions/getshapefiltvolinternalsaturate.md)
- [ShapeFiltVolContext](/ko/reference/audio/shapefiltvolcontext/shapefiltvolcontext_members.md)
- [SetShapeFiltVolCommand](/ko/reference/audio/shapeflowgraph/functions/setshapefiltvolcommand.md)