Skip to main content

SetShapeAllocMixBufferCommand

가상 믹스 버퍼를 할당합니다.

Syntax

Parameters

command   _Inout_
Type: SHAPE_FLOWGRAPH_COMMAND*
초기화할 SHAPE_FLOWGRAPH_COMMAND 명령입니다. virtualId   
Type: UINT32
믹스 버퍼의 가상 ID로, 0에서 8191(포함) 사이의 값입니다. 할당되는 각 믹스 버퍼는 고유한 가상 ID를 가져야 합니다. numIn   
Type: UINT32
믹스 버퍼로 입력되는 수입니다. 이 값은 이 믹스 버퍼로 출력을 보낼 Scalable Hardware Audio Processing Engine(SHAPE) 블록의 수를 지정합니다. numOut   
Type: UINT32
믹스 버퍼로부터의 출력 수입니다. 이 값은 이 믹스 버퍼에서 읽어들일 SHAPE 블록의 수를 지정합니다. attenuation   
Type: SHAPE_MIXBUFFER_ATTENUATION
SHAPE_MIXBUFFER_ATTENUATION 열거형의 멤버 중 하나입니다. 이 값은 이 믹스 버퍼로 들어오는 모든 입력에 적용되는 dB 감쇠를 지정합니다.

Return value

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

Remarks

모든 믹스 버퍼는 단일 채널(모노)이며 사용 전에 할당되어야 합니다. 물리 믹스 버퍼는 총 128개이지만, 사용 가능한 가상 믹스 버퍼는 8192개입니다. 물리 믹스 버퍼는 재사용할 수 있지만 가상 믹스 버퍼는 재사용할 수 없습니다. 실행 목록은 믹스 버퍼 할당에 가상 ID를 사용합니다. 할당 명령이 실행될 때만 물리 믹스 버퍼가 주어진 가상 ID에 바인딩됩니다. 주어진 가상 ID를 사용하는 이후 명령은 할당된 물리 믹스 버퍼로 전달됩니다. 할당 명령은 SHAPE 프로세서에서 믹스 버퍼 블록으로 디스패치되며, 여기서 가상 ID와 물리 믹스 버퍼의 바인딩이 수행됩니다. 많은 타이틀은 플로우그래프를 직접 구현하지 않습니다. XAudio2와 오디오 미들웨어는 SHAPE 구성 요소를 암묵적으로 구현합니다. 그러나 플로우그래프를 직접 구성하면 XBOX One 콘솔의 오디오 가속 기능에 대한 최대의 유연성과 접근성을 얻을 수 있습니다.

Requirements

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

See also

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