> ## 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](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_context)
  * [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_eqcomp_context)
  * [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_filtvol_context)
  * [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_pcm_context)
  * [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_src_context)
  * [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT](/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_context)

## 需求

**標頭：** acphal.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 概念文件

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

## 另請參閱

[AcpHal](/zh-TW/reference/audio/acphal/acphal_members)


## Related topics

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