> ## 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

Comando para carregar um flowgraph.

## Sintaxe

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

### Membros

*numCommands*\
Tipo: UINT32

Número de comandos no flowgraph.

*flowgraph*\
Tipo: APU\_ADDRESS

Endereço físico do flowgraph.

*persist*\
Tipo: UINT32

1 == persistir em vários quadros; 0 == processar uma vez e descartar.

*waitForStart*\
Tipo: UINT32

Defina como 1 para aguardar um comando de início (consulte Comentários).

## Comentários

Defina o sinalizador *waitForStart* para indicar que o processamento do flowgraph deve aguardar o comando `ACP_COMMAND_TYPE_START_FLOWGRAPH`. Um título pode usar isso como um dos vários métodos para sincronizar atualizações de contexto com o processamento do flowgraph.

Um título pode enviar um flowgraph com o sinalizador *waitForStart* definido. O ACP manterá o flowgraph, mas não o processará. O título pode então manipular diretamente os dados de contexto associados ao flowgraph, simplesmente porque o ACP não está processando o flowgraph. Depois de atualizar os contextos, o título emitirá o comando `ACP_COMMAND_TYPE_START_FLOWGRAPH`, que instrui o ACP a começar a processar o flowgraph.

Se o ACP estiver processando um flowgraph, o título não deverá modificar nenhum dado de contexto diretamente. Em vez disso, o título fará uma das seguintes ações:

* Atualizar diretamente os contextos quando o ACP não estiver processando o flowgraph
* Usar os comandos de contexto UPDATE:

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

## Requisitos

**Cabeçalho:** acphal.h

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)

## Confira também

[AcpHal](/pt-BR/reference/audio/acphal/acphal_members)


## Related topics

- [Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview.md)
- [ACP_COMMAND_TYPE](/pt-BR/reference/audio/acphal/enums/acp_command_type.md)
- [AcpHal](/pt-BR/reference/audio/acphal/acphal_members.md)
- [SHAPE_FLOWGRAPH_COMMAND](/pt-BR/reference/audio/shapeflowgraph/structs/shape_flowgraph_command.md)
- [SHAPE_FLOWGRAPH_SRC_COMMAND](/pt-BR/reference/audio/shapeflowgraph/structs/shape_flowgraph_src_command.md)