Skip to main content

SHAPE_FLOWGRAPH_ALLOC_MIXBUFFER_COMMAND

Allocates a physical mix buffer for subsequent use.

Syntax

Members

command
Type: UINT64
The SHAPE_FLOWGRAPH_COMMAND_TYPE_ALLOCMIXBUFFER command from SHAPE_FLOWGRAPH_COMMAND_TYPE. queued
Type: UINT64
Internal process flag: 1 == inserted into the internal command queue; 0 == waiting. disabled
Type: UINT64
Flag for disabling the command: 1 == disabled (don’t process); 0 == enabled (process normally). error
Type: UINT64
Command is invalid. Set by the Audio Control Processor (ACP). reserved0
Type: UINT64
Reserved. numIn
Type: UINT64
Number of inputs. The mix buffer will not output anything until all inputs have completed. numOut
Type: UINT64
Number of outputs. The mix buffer will not be released until all outputs have completed. virtualId
Type: UINT64
Virtual ID, from 0 to 8191. There is a maximum of 8192 virtual mix buffers. attenuate
Type: UINT64
Attenuation: 0 == none; all other values indicate the number of bits the input data is to be shifted by. For information on attenuation applied to a mix buffer, see SHAPE_MIXBUFFER_ATTENUATION. reserved1
Type: UINT64
Reserved.

Remarks

The execution list uses virtual IDs for mix buffer assignments. It is only when an allocate command is executed that a physical mix buffer is bound to a specified virtual ID. Subsequent commands that use a specified virtual ID will be directed to the allocated physical mix buffer. The allocate command is dispatched from the Scalable Hardware Audio Processing Engine (SHAPE) processor to the mix buffer block, where it binds the virtual ID to the physical mix buffer.

Requirements

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

See also

ACP Overview SHAPE Overview shapeflowgraph
Last modified on August 20, 2026