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

# XDspSubmitCommand

> XDspSubmitCommand

# XDspSubmitCommand

Soumet une commande à la file d'attente matérielle pour un flux XDSP donné.

## Syntaxe

```cpp theme={null}
HRESULT XDspSubmitCommand(  
         XDspStreamHandle handle,  
         XDspCommand* command,  
         uint32_t* commandSequence  
)  
```

### Paramètres

*handle*   \_In\_\
Type : [XDspStreamHandle](/fr/reference/audio/xdspaudio/handles/xdspstreamhandle)

Handle de flux XDSP valide.

*command*   \_In\_\
Type : [XDspCommand\*](/fr/reference/audio/xdspaudio/structs/xdspcommand)

Pointeur vers une structure [XDspCommand](/fr/reference/audio/xdspaudio/structs/xdspcommand).

*commandSequence*   \_Out\_\
Type : uint32\_t\*

Pointeur vers un `uint32_t` destiné à renvoyer une valeur de séquence de commande. Pour plus de détails, consultez la section **Remarques**.

### Valeur renvoyée

Type : HRESULT

Si la méthode réussit, elle renvoie S\_OK. Si la méthode échoue, elle renvoie le code suivant (liste partielle) :

| Code de retour | Description |
| - | - |
| E\_INVALIDARG | Un ou plusieurs des arguments ne sont pas valides. |
| XDSP\_E\_QUEUE\_FULL | Cet appel renvoie XDSP\_E\_QUEUE\_FULL si le flux et le serveur matériel ont atteint leur capacité de traitement maximale. Attendez que le matériel traite les commandes avant d'en soumettre d'autres. |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | Si le serveur matériel est dans un état incorrect, **XDspSubmitCommand** renvoie le code d'erreur XDSP\_E\_DEVICE\_FATAL\_ERROR. |

## Remarques

Cet appel est rapide, car il n'alloue pas de ressources et ne traite pas de données ; il se contente d'envoyer la commande au serveur matériel.

Cet appel accepte également un pointeur vers un `uint32_t` pour renvoyer une valeur de séquence de commande, *commandSequence*, qui permet de savoir ultérieurement quand le résultat de la commande est prêt. Ce nombre représente le nombre total de commandes soumises avec succès depuis le début de la session et après l'appel de [XDspActivate](/fr/reference/audio/xdspaudio/functions/xdspactivate). Ce nombre vaut un pour la première commande et est incrémenté de un pour chaque appel réussi à [XDspSubmitCommand](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommand) par la suite.

Si le serveur matériel est dans un état incorrect, **XDspSubmitCommand** renvoie le code d'erreur XDSP\_E\_DEVICE\_FATAL\_ERROR. À ce stade, plus aucune commande ne peut être soumise pour le flux XDSP en état d'échec. [XDspStatus](/fr/reference/audio/xdspaudio/structs/xdspstatus) pour ce flux indiquera également la même erreur. Le flux XDSP concerné doit attendre que toutes les commandes soumises soient traitées par le matériel en vérifiant [XDspStatus](/fr/reference/audio/xdspaudio/structs/xdspstatus), puis il doit être désactivé à l'aide de [XDspDeactivate](/fr/reference/audio/xdspaudio/functions/xdspdeactivate) une fois toutes les commandes traitées. Les autres flux XDSP ne sont pas affectés et le matériel continue de traiter leurs commandes.

## Configuration requise

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

**Bibliothèque :** Chad.lib

**Plateformes prises en charge :** XBOX Series X|S

## Documentation conceptuelle

* [Vue d'ensemble de l'enveloppe XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-enveloping)
* [Vue d'ensemble d'une convolution avec enveloppe sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [Vue d'ensemble de XDSP](/fr/build/console-features/audio/overviews/xdsp-overview)

## Voir aussi

[XDSP](/fr/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommandWithEnvelope](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope)\
[Erreurs XDSP](/fr/reference/audio/xdspaudio/enums/xdsperrors)\
[Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Vue d'ensemble d'une FFT/IFFT sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\
[Vue d'ensemble d'une convolution avec enveloppe sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)


## Related topics

- [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand.md)
- [XDspSubmitCommandWithEnvelope](/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)