> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH

> ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH

# ACP\_COMMAND\_LOAD\_SHAPE\_FLOWGRAPH

加载流程图的命令。

## 语法

```cpp theme={null}
typedef struct ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH {  
    UINT32 numCommands;  
    APU_ADDRESS flowgraph;  
    UINT32 persist;  
    UINT32 waitForStart;  
} ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH  
```

### 成员

*numCommands*\
类型:UINT32

流程图中的命令数量。

*flowgraph*\
类型:APU\_ADDRESS

流程图的物理地址。

*persist*\
类型:UINT32

1 == 在多个帧中持续保留;0 == 处理一次后丢弃。

*waitForStart*\
类型:UINT32

设为 1 以等待启动命令(请参阅"备注")。

## 备注

设置 *waitForStart* 标志以指示流程图的处理将等待 `ACP_COMMAND_TYPE_START_FLOWGRAPH` 命令。游戏可以将此作为将上下文更新与流程图处理同步的几种方法之一。

游戏可以提交一个设置了 *waitForStart* 标志的流程图。ACP 会保留该流程图但不进行处理。此时游戏可以直接操作与该流程图关联的上下文数据,因为 ACP 并未处理该流程图。在更新完上下文后,游戏发出 `ACP_COMMAND_TYPE_START_FLOWGRAPH` 命令,通知 ACP 开始处理流程图。

如果 ACP 正在处理流程图,游戏不应直接修改任何上下文数据。相反,游戏应执行以下操作之一:

* 在 ACP 未处理流程图时直接更新上下文
* 使用 UPDATE 上下文命令:

  * [ACP\_COMMAND\_UPDATE\_DMA\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_dma_context)
  * [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_eqcomp_context)
  * [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_filtvol_context)
  * [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_pcm_context)
  * [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_src_context)
  * [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT](/reference/audio/acphal/structs/acp_command_update_xma_context)

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 概念文档

* [ACP 概述](/build/console-features/audio/overviews/acp-overview)

## 另请参阅

[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [ACP 概述](/zh-CN/build/console-features/audio/overviews/acp-overview.md)
- [AcpHal](/zh-CN/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_TYPE](/zh-CN/reference/audio/acphal/enums/acp_command_type.md)
- [SHAPE_FLOWGRAPH_COMMAND](/zh-CN/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SHAPE_FLOWGRAPH_SRC_COMMAND](/zh-CN/reference/audio/shapeflowgraph/structs/shape_flowgraph_src_command.md)