> ## 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 de chargement d'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 == persister sur plusieurs trames; 0 == traiter une fois, puis supprimer.

*waitForStart*\
Type : UINT32

Définissez sur 1 pour attendre une commande de démarrage (voir les 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 utiliser ce mécanisme 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 conservera le graphe de flux, mais ne le traitera pas. Le titre peut alors 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 émettra 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 effectuera plutôt l'une des opérations suivantes :

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

  * [ACP\_COMMAND\_UPDATE\_DMA\_CONTEXT](/fr-CA/reference/audio/acphal/structs/acp_command_update_dma_context)
  * [ACP\_COMMAND\_UPDATE\_EQCOMP\_CONTEXT](/fr-CA/reference/audio/acphal/structs/acp_command_update_eqcomp_context)
  * [ACP\_COMMAND\_UPDATE\_FILTVOL\_CONTEXT](/fr-CA/reference/audio/acphal/structs/acp_command_update_filtvol_context)
  * [ACP\_COMMAND\_UPDATE\_PCM\_CONTEXT](/fr-CA/reference/audio/acphal/structs/acp_command_update_pcm_context)
  * [ACP\_COMMAND\_UPDATE\_SRC\_CONTEXT](/fr-CA/reference/audio/acphal/structs/acp_command_update_src_context)
  * [ACP\_COMMAND\_UPDATE\_XMA\_CONTEXT](/fr-CA/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-CA/build/console-features/audio/overviews/acp-overview)

## Voir aussi

[AcpHal](/fr-CA/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)
