Skip to main content

GetShapePcmAudioBuffer

PCM 컨텍스트의 오디오 버퍼를 가져옵니다.

Syntax

Parameters

context   _In_
Type: SHAPE_PCM_CONTEXT*
SHAPE_PCM_CONTEXT 구조체에 대한 포인터입니다.

Return value

Type: void* 오디오 버퍼에 대한 포인터입니다.

Remarks

Sample Rate Convertor(SRC) 블록은 시스템 메모리에서 16비트, 24비트, 32비트 고정 소수점 또는 32비트 부동 소수점 Pulse Code Modulation(PCM) 데이터를 읽고 정수 기반 샘플링 레이트 변환을 수행합니다. 출력 데이터는 믹스 버퍼에 기록됩니다. 입력 데이터로 SRC 블록은 XBOX Media Audio(XMA) 하드웨어 디코더의 출력이나 소프트웨어에서 관리되는 데이터를 사용할 수 있습니다. SRC 블록은 XMA 디코더와 긴밀하게 통합되어 있어, 메인 메모리를 읽지 않고도 XMA 디코드 버퍼에 충분한 디코드된 PCM 데이터 샘플이 있는지 확인할 수 있습니다. SRC 프로세스는 일반적으로 악기 에뮬레이션, 입력 샘플을 원본보다 한 옥타브 낮거나 높게 변환, 또는 도플러 효과와 같은 효과에 사용됩니다. SRC는 모노 또는 스테레오 모드 중 하나로 동작합니다. PCM 데이터는 메모리에서 읽혀 샘플링 레이트 변환을 위해 공통 24비트 고정 소수점 형식으로 변환됩니다. 출력은 모드에 따라 하나 또는 두 개의 믹스 버퍼에 기록됩니다. 스테레오 데이터는 인터리브된 16비트 데이터 스트림으로 메모리에 저장되며, 각 32비트 워드의 하위 16비트에 좌측 채널이, 상위 16비트에 우측 채널이 저장됩니다. 스테레오 모드에서는 PCM 데이터가 읽히는 동시에 디인터리브됩니다. 좌측 채널 데이터(짝수 번호 샘플)는 처리되어 한 믹스 버퍼로 출력되고, 우측 채널 데이터(홀수 번호 샘플)는 다른 믹스 버퍼로 기록됩니다.

Requirements

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

See also

ACP 개요
Shape 개요
shapepcmcontext
마지막 수정일 2026년 8월 24일