Skip to main content

SHAPE_PCM_CONTEXT

The PCM context structure.

Syntax

Members

bufferStart
Type: UINT32
Write: Audio buffer. bufferLength
Type: UINT32
Write: Length of the audio buffer in samples. reserved0
Type: UINT32
Reserved. loopCount
Type: UINT32
Read/Write: Loop count. reserved1
Type: UINT32
Reserved. full
Type: UINT32
Write: For circular buffers, when readPointer is the same as loopStartWritePointer: 1 == full buffer, 0 == empty buffer. reserved2
Type: UINT32
Reserved. readPointer
Type: UINT32
Read/Write: Frame-aligned, 128-sample offset in samples from the beginning of the audio buffer. Lower seven (7) bits are ignored. reserved3
Type: UINT32
Reserved. loopStartWritePointer
Type: UINT32
Write: Non-frame–aligned sample offset from the beginning of the audio buffer. Indicates the loop start for linear buffers, or the write pointer for circular buffers. reserved4
Type: UINT32
Reserved. loopEnd
Type: UINT32
Write: Non-frame–aligned sample offset from the beginning of the audio buffer. Indicates the loop end. Minimum loop size is 128 samples. reserved5
Type: UINT32
Reserved. mode
Type: UINT32
Write: SHAPE_PCM_MODE reserved6
Type: UINT32
Reserved. format
Type: UINT32
Write: SHAPE_PCM_FORMAT reserved7
Type: UINT32
Reserved. reserved
Type: UINT32[1]
Reserved.

Remarks

The fields marked as Write are set by your application and are not changed by the Audio Control Processor (ACP) library. The fields marked as Read/Write are set by your application but can be changed by the ACP library. The size of a Pulse Code Modulation (PCM) buffer depends on the buffer’s format. See the remarks for SHAPE_PCM_FORMAT.

Requirements

Header: shapepcmcontext.h Supported platforms: XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

Overview of ACP
Overview of Shape
shapepcmcontext
Last modified on August 20, 2026