> ## 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-CA/reference/audio/xdspaudio/handles/xdspstreamhandle)

Handle de flux XDSP valide.

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

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

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

Pointeur vers un `uint32_t` permettant de retourner une valeur de séquence de commande. Consultez la section **Remarques** pour plus de détails.

### Valeur de retour

Type : HRESULT

Si la méthode réussit, elle retourne S\_OK. Si la méthode échoue, elle retourne 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 retourne 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** retourne 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 envoie simplement la commande au serveur matériel.

Cet appel accepte également un pointeur vers un `uint32_t` pour retourner une valeur de séquence de commande, *commandSequence*, qui permet de savoir plus tard quand le résultat de la commande est prêt. Ce nombre représente le nombre total de commandes qui ont été soumises avec succès depuis le début de la session et après l'appel de [XDspActivate](/fr-CA/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-CA/reference/audio/xdspaudio/functions/xdspsubmitcommand) par la suite.

Si le serveur matériel est dans un état incorrect, **XDspSubmitCommand** retourne le code d'erreur XDSP\_E\_DEVICE\_FATAL\_ERROR. À ce moment, aucune autre commande ne peut être soumise pour le flux XDSP en état d'échec. [XDspStatus](/fr-CA/reference/audio/xdspaudio/structs/xdspstatus) pour le flux indiquera également la même erreur. Le flux XDSP touché doit attendre que toutes les commandes soumises soient traitées par le matériel en vérifiant [XDspStatus](/fr-CA/reference/audio/xdspaudio/structs/xdspstatus), et il doit être désactivé à l'aide de [XDspDeactivate](/fr-CA/reference/audio/xdspaudio/functions/xdspdeactivate) une fois toutes les commandes traitées. Les autres flux XDSP ne seront pas touchés et le matériel continuera 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-CA/build/console-features/audio/overviews/xdsp-overview-enveloping)
* [Vue d'ensemble d'une convolution à flux unique avec enveloppe à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Vue d'ensemble d'une convolution à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [Vue d'ensemble de XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview)

## Voir aussi

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


## Related topics

- [XDspSubmitCommandWithEnvelope](/fr-CA/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspCommand](/fr-CA/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStatus](/fr-CA/reference/audio/xdspaudio/structs/xdspstatus.md)
- [Vue d'ensemble de l'enveloppe XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-enveloping.md)
- [Convolution à flux unique avec enveloppe à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)