Skip to main content

​
XDspActivate

Active un flux XDSP en acquérant une ressource de traitement libre dans le pool. Chaque client XDSP est limité à 256 activations de flux.

​
Syntaxe

​
Paramètres

clientHandle   _In_
Type : XDspClientHandle Handle de client XDSP valide obtenu à partir de l’appel à XDspConnect. params   _In_
Type : XDspActivationParameters* Pointeur vers une structure XDspActivationParameters. status   _Outptr_
Type : XDspStatus** Pointeur vers une structure XDspStatus. Consultez la section Remarques pour plus de détails. streamHandle   _Outptr_
Type : XDspStreamHandle* XDspStreamHandle valide, si l’appel réussit. 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 l’un des codes suivants (liste partielle) :

​
Remarques

Cet appel est rapide, car il acquiert des ressources dans le pool au lieu de les allouer. L’appelant doit spécifier un XDspProcessType que le flux XDSP doit effectuer. Une instance de flux XDSP ne peut fonctionner qu’avec un seul type de traitement pendant sa durée de vie. Pour effectuer deux types de traitement différents ou plus, il faut instancier deux instances de flux XDSP ou plus. Dans la structure XDspActivationParameters, l’appelant doit spécifier les éléments suivants :
  • Les options d’activation.
  • Le nombre de trames qui seront traitées dans chaque commande, c.-à-d. le nombre de trames d’entrée et de sortie.
  • Le nombre de canaux du flux. Seuls les flux d’entrée mono et stéréo sont pris en charge.
  • Pour le type de traitement XDspProcessType::Convolution, la longueur de la réponse impulsionnelle en nombres à virgule flottante.
  • Pour le type de traitement XDspProcessType::Convolution, la réponse impulsionnelle sous forme de valeurs du domaine fréquentiel.
Si l’appel réussit, un XDspStreamHandle valide sera retourné pour être utilisé avec d’autres appels (XDspSubmitCommand, XDspSubmitCommandWithEnvelope, XDspDeactivate) pour ce flux. De plus, si cet appel réussit, il retournera un pointeur vers XDspStatus qui peut être utilisé pour vérifier l’état des commandes soumises. Celui-ci doit être utilisé pour déterminer la dernière commande traitée et si les résultats des commandes soumises sont prêts à être consommés. XDspStatus contient également le numéro de séquence de la dernière commande soumise au matériel et le numéro de séquence de la première commande ayant échoué pour le flux XDSP qu’il représente. Dans le cas d’un traitement de convolution, l’appelant peut libérer la mémoire de la réponse impulsionnelle après le retour de cet appel.

​
Configuration requise

En-tête : XDspAudio.h Bibliothèque : Chad.lib Plateformes prises en charge : XBOX Series X|S

​
Documentation conceptuelle

​
Voir aussi

XDSP
Erreurs XDSP
Vue d’ensemble d’une convolution à flux unique à l’aide de l’API XDSP
Vue d’ensemble d’une FFT/IFFT à flux unique à l’aide de l’API XDSP
Vue d’ensemble d’une convolution à flux unique avec enveloppe à l’aide de l’API XDSP
Last modified on October 6, 2026