> ## 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 を設定します (解説を参照)。

## 解説

フローグラフの処理が `ACP_COMMAND_TYPE_START_FLOWGRAPH` コマンドを待機することを示すには、*waitForStart* フラグを設定します。タイトルはこれを、フローグラフ処理とコンテキスト更新を同期させる複数の方法の 1 つとして使用できます。

タイトルは *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 の概要](/ja-jp/build/console-features/audio/overviews/acp-overview.md)
- [ACP_COMMAND_TYPE](/ja-jp/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/ja-jp/reference/audio/acphal/acphal_members.md)
- [SHAPE_FLOWGRAPH_SRC_COMMAND](/ja-jp/reference/audio/shapeflowgraph/structs/shape_flowgraph_src_command.md)
- [SHAPE_FLOWGRAPH_COMMAND_TYPE](/ja-jp/reference/audio/shapeflowgraph/enums/shape_flowgraph_command_type.md)