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

Envía un comando a la cola de hardware para una secuencia de XDSP determinada.

## Sintaxis

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

### Parámetros

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

Un identificador de secuencia de XDSP válido.

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

Puntero a una estructura [XDspCommand](/reference/audio/xdspaudio/structs/xdspcommand).

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

Puntero a `uint32_t` para devolver un valor de secuencia de comandos. Consulte la sección **Comentarios** para obtener más detalles.

### Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, devuelve S\_OK. Si el método no se ejecuta correctamente, devuelve el código siguiente (lista parcial):

| Código devuelto               | Descripción                                                                                                                                                                                                        |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| E\_INVALIDARG                 | Uno o varios de los argumentos no son válidos.                                                                                                                                                                     |
| XDSP\_E\_QUEUE\_FULL          | Esta llamada devolverá XDSP\_E\_QUEUE\_FULL si la secuencia y el servidor de hardware alcanzaron la capacidad máxima de procesamiento. Espere a que el hardware procese los comandos antes de enviar más comandos. |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | Si el servidor de hardware está en un estado incorrecto, **XDspSubmitCommand** devolverá el código de error XDSP\_E\_DEVICE\_FATAL\_ERROR.                                                                         |

## Comentarios

Esta llamada será rápida, ya que no asigna recursos ni procesa datos y solo envía el comando al servidor de hardware.

Esta llamada también toma un puntero a `uint32_t` para devolver un valor de secuencia de comandos, *commandSequence*, con el fin de realizar un seguimiento de cuándo estará listo más adelante el resultado del comando. Este número representa el número total de comandos que se han enviado correctamente desde que se inició la sesión y después de llamar a [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate). Este número será uno para el primer comando y se incrementa en uno por cada llamada correcta a [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand) posterior.

Si el servidor de hardware está en un estado incorrecto, **XDspSubmitCommand** devolverá el código de error XDSP\_E\_DEVICE\_FATAL\_ERROR. En este punto, no se pueden enviar más comandos para la secuencia de XDSP que está en estado de error. [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) para la secuencia también indicará el mismo error. La secuencia de XDSP afectada debe esperar a que el hardware procese todos los comandos enviados comprobando [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus) y debe desactivarse mediante [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate) una vez que se procesen todos los comandos. Las demás secuencias de XDSP no se verán afectadas y el hardware seguirá procesando sus comandos.

## Requisitos

**Encabezado:** XDspAudio.h

**Biblioteca:** Chad.lib

**Plataformas compatibles:** XBOX Series X|S

## Documentación conceptual

* [Información general del uso de envolventes de XDSP](/build/console-features/audio/overviews/xdsp-overview-enveloping)
* [Información general de una convolución de secuencia única con envolvente mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Información general de una convolución de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [Información general de XDSP](/build/console-features/audio/overviews/xdsp-overview)

## Consulte también

[XDSP](/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommandWithEnvelope](/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope)\
[Errores de XDSP](/reference/audio/xdspaudio/enums/xdsperrors)\
[Información general de una convolución de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Información general de una FFT/IFFT de secuencia única mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\
[Información general de una convolución de secuencia única con envolvente mediante la API de XDSP](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)


## Related topics

- [XDspSubmitCommandWithEnvelope](/es/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope.md)
- [XDspCommand](/es/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStatus](/es/reference/audio/xdspaudio/structs/xdspstatus.md)
- [Información general sobre la envolvente de XDSP](/es/build/console-features/audio/overviews/xdsp-overview-enveloping.md)
- [Convolución de secuencia única con envolvente mediante la API XDSP](/es/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)