Skip to main content

​
XDspActivate

Ativa o fluxo XDSP adquirindo um recurso de processamento livre do pool. Cada cliente XDSP é limitado a 256 ativações de fluxo.

​
Sintaxe

​
Parâmetros

clientHandle   _In_
Tipo: XDspClientHandle Um identificador de cliente XDSP válido obtido da chamada a XDspConnect. params   _In_
Tipo: XDspActivationParameters* Ponteiro para uma estrutura XDspActivationParameters. status   _Outptr_
Tipo: XDspStatus** Ponteiro para uma estrutura XDspStatus. Confira a seção Comentários para obter detalhes adicionais. streamHandle   _Outptr_
Tipo: XDspStreamHandle* XDspStreamHandle válido, se a chamada for bem-sucedida. 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á um dos seguintes códigos (lista parcial):

​
Comentários

Essa chamada é rápida, pois adquire recursos do pool em vez de alocá-los. O chamador deve especificar um XDspProcessType para o fluxo XDSP executar. Uma instância de fluxo XDSP pode trabalhar com apenas um tipo de processamento durante seu tempo de vida. Para executar dois ou mais tipos de processamento diferentes, duas ou mais instâncias de fluxo XDSP devem ser instanciadas. Dentro da estrutura XDspActivationParameters, o chamador deve especificar o seguinte:
  • Opções de ativação.
  • Número de quadros que serão processados em cada comando, ou seja, o número de quadros de entrada e saída.
  • Número de canais do fluxo. Somente fluxos de entrada mono e estéreo são compatíveis.
  • Para o tipo de processamento XDspProcessType::Convolution, o comprimento da resposta ao impulso em floats.
  • Para o tipo de processamento XDspProcessType::Convolution, a resposta ao impulso como valores no domínio da frequência.
Se a chamada for bem-sucedida, um XDspStreamHandle válido será retornado para ser usado com outras chamadas (XDspSubmitCommand, XDspSubmitCommandWithEnvelope, XDspDeactivate) para esse fluxo. Além disso, se essa chamada for bem-sucedida, ela retornará um ponteiro para XDspStatus que pode ser usado para verificar o status dos comandos enviados. Isso deve ser usado para determinar o comando mais recente que foi processado e se os resultados dos comandos enviados estão prontos para serem consumidos. XDspStatus também tem o número de sequência do último comando enviado ao hardware e o número de sequência do primeiro comando com falha para o fluxo XDSP que ele representa. No caso de processamento de convolução, o chamador pode liberar a memória da resposta ao impulso depois que essa chamada retornar.

​
Requisitos

Cabeçalho: XDspAudio.h Biblioteca: Chad.lib Plataformas compatíveis: XBOX Series X|S

​
Documentação conceitual

​
Confira também

XDSP
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