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

# SetShapeSrcCommand function

> SetShapeSrcCommand function

# SetShapeSrcCommand function

SHAPE SRC 명령을 초기화합니다.

## Syntax

```cpp theme={null}
HRESULT SetShapeSrcCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 leftorMonoMixBuffer,  
         UINT32 rightMixBuffer  
)  
```

### Parameters

*command*   \_Inout\_\
Type: SHAPE\_FLOWGRAPH\_COMMAND\*

초기화할 [SHAPE\_FLOWGRAPH\_COMMAND](/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) 명령입니다.

*contextId*   \
Type: UINT32

이 명령이 참조할 SRC 컨텍스트 ID(인덱스)입니다.

*leftorMonoMixBuffer*   \
Type: UINT32

입력 믹스 버퍼 ID입니다.

*rightMixBuffer*   \
Type: UINT32

출력 믹스 버퍼 ID입니다.

### Return value

Type: HRESULT

함수가 성공하면 `S_OK`를 반환합니다. 하나 이상의 인수가 유효하지 않으면 `E_INVALIDARG`를 반환합니다.

## Remarks

플로우그래프는 지속적(persistent) 또는 비지속적(non-persistent) 방식으로 처리되도록 제출할 수 있습니다. 지속적 플로우그래프는 처리된 후에도 상주하여 읽기/쓰기 포인터가 진행되고 기타 컨텍스트 정보가 업데이트된 다음 프레임에서 처리를 반복합니다. 다음 시나리오 중 하나에 해당하는 경우 지속적 플로우그래프를 사용할 수 있습니다.

* **매우 복잡한 플로우그래프** - 프레임마다 재조립하는 데 상당한 CPU 처리가 필요한 경우.
* **매우 정적인 플로우그래프** - 장시간 동일한 수와 구성의 보이스를 유지하는 경우.

다음 시나리오 중 어느 하나에 해당하는 경우 비지속적 플로우그래프를 사용하세요.

* 보이스 토폴로지가 자주 변경되는 경우.
* 타이틀의 오디오 소프트웨어 엔진 처리 주기가 SHAPE 하드웨어에서 분리되어 2.667ms의 배수가 아닌 경우.
* 오디오 처리를 실시간보다 빠르게 실행하여 그래프가 사용 가능해지는 즉시 소비되도록 제출하려는 경우.

많은 타이틀은 플로우그래프를 직접 구현하지 않습니다. [XAudio2](/build/console-features/audio/overviews/xaudio2-overview)와 오디오 미들웨어는 SHAPE 구성 요소를 암묵적으로 구현합니다. 그러나 플로우그래프를 직접 구성하면 XBOX One 콘솔의 오디오 가속 기능에 대한 최대의 유연성과 접근성을 얻을 수 있습니다.

## Requirements

**Header:** shapeflowgraph.h

**Supported platforms:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## See also

[SHAPE 개요](/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [ShapeFlowGraph](/ko/reference/audio/shapeflowgraph/shapeflowgraph_members.md)
- [SetShapeSrcCommand](/ko/reference/audio/shapesrccontext/functions/shapesrccontext_setshapesrccommand.md)
- [SHAPE_SRC_COMMAND_TYPE](/ko/reference/audio/shapesrccontext/enums/shape_src_command_type.md)
- [GetShapeSrcCommandType](/ko/reference/audio/shapesrccontext/functions/getshapesrccommandtype.md)
- [ShapeSrcContext](/ko/reference/audio/shapesrccontext/shapesrccontext_members.md)