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

Envia um comando para a fila de hardware de um determinado fluxo XDSP.

## Sintaxe

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

### Parâmetros

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

Um identificador de fluxo XDSP válido.

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

Ponteiro para uma estrutura [XDspCommand](/pt-BR/reference/audio/xdspaudio/structs/xdspcommand).

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

Ponteiro para `uint32_t` para retornar um valor de sequência de comando. Confira a seção **Comentários** para obter detalhes adicionais.

### Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S\_OK. Se o método falhar, ele retornará o seguinte código (lista parcial):

| Código de retorno | Descrição |
| - | - |
| E\_INVALIDARG | Um ou mais argumentos são inválidos. |
| XDSP\_E\_QUEUE\_FULL | Essa chamada retornará XDSP\_E\_QUEUE\_FULL se o fluxo e o servidor de hardware atingirem a capacidade máxima de processamento. Aguarde o hardware processar os comandos antes de enviar mais comandos. |
| XDSP\_E\_DEVICE\_FATAL\_ERROR | Se o servidor de hardware estiver em um estado inválido, **XDspSubmitCommand** retornará o código de erro XDSP\_E\_DEVICE\_FATAL\_ERROR. |

## Comentários

Essa chamada será rápida, pois não alocará recursos nem processará dados; ela apenas envia o comando ao servidor de hardware.

Essa chamada também recebe um ponteiro para `uint32_t` para retornar um valor de sequência de comando, *commandSequence*, para rastrear quando o resultado do comando estará pronto posteriormente. Esse número representa o total de comandos que foram enviados com êxito desde que a sessão foi iniciada e depois que [XDspActivate](/pt-BR/reference/audio/xdspaudio/functions/xdspactivate) foi chamado. Esse número será um para o primeiro comando e é incrementado em um para cada chamada bem-sucedida de [XDspSubmitCommand](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommand) depois disso.

Se o servidor de hardware estiver em um estado inválido, **XDspSubmitCommand** retornará o código de erro XDSP\_E\_DEVICE\_FATAL\_ERROR. Nesse ponto, nenhum outro comando poderá ser enviado para o fluxo XDSP que está em estado de falha. O [XDspStatus](/pt-BR/reference/audio/xdspaudio/structs/xdspstatus) do fluxo também indicará o mesmo erro. O fluxo XDSP afetado deve aguardar até que todos os comandos enviados sejam processados pelo hardware, verificando o [XDspStatus](/pt-BR/reference/audio/xdspaudio/structs/xdspstatus), e deve ser desativado usando [XDspDeactivate](/pt-BR/reference/audio/xdspaudio/functions/xdspdeactivate) quando todos os comandos forem processados. Outros fluxos XDSP não serão afetados, e o hardware continuará a processar os comandos deles.

## Requisitos

**Cabeçalho:** XDspAudio.h

**Biblioteca:** Chad.lib

**Plataformas compatíveis:** XBOX Series X|S

## Documentação conceitual

* [Visão geral do envelopamento do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-enveloping)
* [Visão geral de uma convolução de fluxo único com envelope usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [Visão geral de uma convolução de fluxo único usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)
* [Visão geral do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview)

## Confira também

[XDSP](/pt-BR/reference/audio/xdspaudio/xdspaudio_members)\
[XDspSubmitCommandWithEnvelope](/pt-BR/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope)\
[Erros do XDSP](/pt-BR/reference/audio/xdspaudio/enums/xdsperrors)\
[Visão geral de uma convolução de fluxo único usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[Visão geral de uma FFT/IFFT de fluxo único usando a API do XDSP](/pt-BR/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\
[Visão geral de uma convolução de fluxo único com envelope usando a API do XDSP](/pt-BR/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)
- [XDspCommand](/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspStatus](/reference/audio/xdspaudio/structs/xdspstatus.md)
- [Single-stream convolution with envelope using the XDSP API](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope.md)