> ## 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* 플래그를 설정합니다. 타이틀은 이를 플로우그래프 처리와 컨텍스트 업데이트를 동기화하는 여러 방법 중 하나로 사용할 수 있습니다.

타이틀은 *waitForStart* 플래그가 설정된 상태로 플로우그래프를 제출할 수 있습니다. ACP는 플로우그래프를 보관하지만 처리하지는 않습니다. 그런 다음 타이틀은 ACP가 플로우그래프를 처리하고 있지 않기 때문에 플로우그래프와 관련된 컨텍스트 데이터를 직접 조작할 수 있습니다. 컨텍스트를 업데이트한 후, 타이틀은 ACP에 플로우그래프 처리를 시작하도록 지시하는 `ACP_COMMAND_TYPE_START_FLOWGRAPH` 명령을 발행합니다.

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 개요](/ko/build/console-features/audio/overviews/acp-overview.md)
- [AcpHal](/ko/reference/audio/acphal/acphal_members.md)
- [ACP_COMMAND_TYPE](/ko/reference/audio/acphal/enums/acp_command_type.md)
- [SHAPE_FLOWGRAPH_COMMAND](/ko/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SHAPE_FLOWGRAPH_SRC_COMMAND](/ko/reference/audio/shapeflowgraph/structs/shape_flowgraph_src_command.md)