ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH Structure

Command to load a flowgraph.

Syntax

struct ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH {
    UINT32 numCommands;
    APU_ADDRESS flowgraph;
    UINT32 persist;
    UINT32 waitForStart;
};  

Members

numCommands
Number of commands in the flowgraph.

flowgraph
Physical address of the flowgraph.

persist
1 == persist over multiple frames, 0 == process once and discard.

waitForStart
Set to 1 to wait for a start command (see Remarks).

Remarks

Set the waitForStart flag to indicate that processing of the flowgraph should wait for the ACP_COMMAND_TYPE_START_FLOWGRAPH command. A title can use this as one of several methods to synchronize context updates with flowgraph processing. A title can submit a flowgraph with the waitForStart flag set. The ACP will hold onto the flowgraph, but not 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 the title has completed updating the contexts, it issues an ACP_COMMAND_TYPE_START_FLOWGRAPH command which tells the ACP to start processing the flowgraph.

If the ACP is processing a flowgraph, the title should not directly modify any of the context data. The title either needs to directly update the contexts when the ACP is not processing the flowgraph, or use the UPDATE context commands.

Requirements

Header: Declared in acphal.h.

Library: Use acphal.lib.