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

Commande permettant de charger un graphe de flux.

## Syntaxe

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

### Membres

*numCommands*\
Type : UINT32

Nombre de commandes dans le graphe de flux.

*flowgraph*\
Type : APU\_ADDRESS

Adresse physique du graphe de flux.

*persist*\
Type : UINT32

1 == persistance sur plusieurs trames ; 0 == traitement unique puis abandon.

*waitForStart*\
Type : UINT32

Définissez sur 1 pour attendre une commande de démarrage (voir Remarques).

## Remarques

Définissez l'indicateur *waitForStart* pour indiquer que le traitement du graphe de flux doit attendre la commande `ACP_COMMAND_TYPE_START_FLOWGRAPH`. Un titre peut l'utiliser comme l'une des différentes méthodes de synchronisation des mises à jour de contexte avec le traitement du graphe de flux.

Un titre peut soumettre un graphe de flux avec l'indicateur *waitForStart* défini. L'ACP conserve alors le graphe de flux mais ne le traite pas. Le titre peut ensuite manipuler directement les données de contexte associées au graphe de flux, simplement parce que l'ACP ne traite pas le graphe de flux. Après avoir mis à jour les contextes, le titre émet la commande `ACP_COMMAND_TYPE_START_FLOWGRAPH` qui indique à l'ACP de commencer à traiter le graphe de flux.

Si l'ACP traite un graphe de flux, le titre ne doit modifier directement aucune donnée de contexte. Le titre doit plutôt procéder de l'une des façons suivantes :

* Mettre à jour directement les contextes lorsque l'ACP ne traite pas le graphe de flux
* Utiliser les commandes de mise à jour (UPDATE) de contexte :

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

## Configuration requise

**En-tête :** acphal.h

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Vue d'ensemble de l'ACP](/fr/build/console-features/audio/overviews/acp-overview)

## Voir aussi

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


## Related topics

- [ACP_COMMAND_LOAD_SHAPE_FLOWGRAPH](/reference/audio/acphal/structs/acp_command_load_shape_flowgraph.md)
- [ACP overview](/build/console-features/audio/overviews/acp-overview.md)
- [ACP 概述](/zh-CN/build/console-features/audio/overviews/acp-overview.md)
- [ACP 개요](/ko/build/console-features/audio/overviews/acp-overview.md)
- [ACP の概要](/ja-jp/build/console-features/audio/overviews/acp-overview.md)