Skip to main content

​
SetShapeSrcCommand function

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

​
Syntax

​
Parameters

command   _Inout_
Type: SHAPE_FLOWGRAPH_COMMAND* 초기화할 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와 오디오 미들웨어는 SHAPE 구성 요소를 암묵적으로 구현합니다. 그러나 플로우그래프를 직접 구성하면 XBOX One 콘솔의 오디오 가속 기능에 대한 최대의 유연성과 접근성을 얻을 수 있습니다.

​
Requirements

Header: shapeflowgraph.h Supported platforms: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

​
See also

SHAPE 개요 shapeflowgraph
마지막 수정일 2026년 8월 24일

관련 항목

ShapeFlowGraphSetShapeSrcCommandSHAPE_SRC_COMMAND_TYPEGetShapeSrcCommandTypeShapeSrcContext