Skip to main content

XDspSubmitCommand

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

Sintaxe

Parâmetros

handle   _In_
Tipo: XDspStreamHandle
Um identificador de fluxo XDSP válido. command   _In_
Tipo: XDspCommand*
Ponteiro para uma estrutura 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):

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 foi chamado. Esse número será um para o primeiro comando e é incrementado em um para cada chamada bem-sucedida de 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 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, e deve ser desativado usando 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

Confira também

XDSP
XDspSubmitCommandWithEnvelope
Erros do XDSP
Visão geral de uma convolução de fluxo único usando a API do XDSP
Visão geral de uma FFT/IFFT de fluxo único usando a API do XDSP
Visão geral de uma convolução de fluxo único com envelope usando a API do XDSP
Last modified on October 6, 2026