Skip to main content

​
XDspActivate

Active un flux XDSP en obtenant 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 lors de l’appel à XDspConnect. params   _In_
Type : XDspActivationParameters* Pointeur vers une structure XDspActivationParameters. status   _Outptr_
Type : XDspStatus** Pointeur vers une structure XDspStatus. Pour plus de détails, consultez la section Remarques. streamHandle   _Outptr_
Type : XDspStreamHandle* XDspStreamHandle valide, si l’appel réussit. Pour plus de détails, consultez la section Remarques.

​
Valeur renvoyée

Type : HRESULT Si la méthode réussit, elle renvoie S_OK. Si la méthode échoue, elle renvoie l’un des codes suivants (liste partielle) :

​
Remarques

Cet appel est rapide, car il obtient les ressources dans le pool au lieu de les allouer. L’appelant doit spécifier un XDspProcessType que le flux XDSP doit exécuter. Une instance de flux XDSP ne peut fonctionner qu’avec un seul type de traitement pendant toute 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’est-à-dire le nombre de trames en entrée et en 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 floats.
  • Pour le type de traitement XDspProcessType::Convolution, la réponse impulsionnelle sous forme de valeurs dans le domaine fréquentiel.
Si l’appel réussit, un XDspStreamHandle valide est renvoyé pour être utilisé avec les autres appels (XDspSubmitCommand, XDspSubmitCommandWithEnvelope, XDspDeactivate) pour ce flux. De plus, si cet appel réussit, il renvoie 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 sur un seul flux à l’aide de l’API XDSP
Vue d’ensemble d’une FFT/IFFT sur un seul flux à l’aide de l’API XDSP
Vue d’ensemble d’une convolution avec enveloppe sur un seul flux à l’aide de l’API XDSP
Last modified on October 6, 2026