Skip to main content

ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH

Command for loading a flowgraph.

Syntax

Members

numCommands
Type: UINT32
Number of commands in the flowgraph. flowgraph
Type: APU_ADDRESS
Physical address of the flowgraph. persist
Type: UINT32
1 == persist over multiple frames; 0 == process once and discard. waitForStart
Type: UINT32
Set to 1 to wait for a start command (see Remarks).

Remarks

Set the waitForStart flag to indicate that processing of the flowgraph is to wait for the ACP_COMMAND_TYPE_START_FLOWGRAPH command. A title can use this as one of several methods for synchronizing context updates with flowgraph processing. A title can submit a flowgraph with the waitForStart flag set. The ACP will hold on to the flowgraph but won’t process it. The title can then directly manipulate the context data associated with the flowgraph, simply because the ACP is not processing the flowgraph. After updating the contexts, the title will issue the ACP_COMMAND_TYPE_START_FLOWGRAPH command that tells the ACP to start processing the flowgraph. If the ACP is processing a flowgraph, the title should not modify any context data directly. Instead, the title will do either of the following:

Requirements

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

Conceptual documentation

See also

AcpHal
Last modified on August 20, 2026