> ## 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. # XDspActivate > XDspActivate # 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 ```cpp theme={null} HRESULT XDspActivate( XDspClientHandle clientHandle, XDspActivationParameters* params, XDspStatus** status, XDspStreamHandle* streamHandle ) ``` ### Paramètres *clientHandle*   \_In\_\ Type : [XDspClientHandle](/fr/reference/audio/xdspaudio/handles/xdspclienthandle) Handle de client XDSP valide obtenu lors de l'appel à XDspConnect. *params*   \_In\_\ Type : [XDspActivationParameters\*](/fr/reference/audio/xdspaudio/structs/xdspactivationparameters) Pointeur vers une structure [XDspActivationParameters](/fr/reference/audio/xdspaudio/structs/xdspactivationparameters). *status*   \_Outptr\_\ Type : [XDspStatus\*\*](/fr/reference/audio/xdspaudio/structs/xdspstatus) Pointeur vers une structure [XDspStatus](/fr/reference/audio/xdspaudio/structs/xdspstatus). Pour plus de détails, consultez la section **Remarques**. *streamHandle*   \_Outptr\_\ Type : [XDspStreamHandle\*](/fr/reference/audio/xdspaudio/handles/xdspstreamhandle) [XDspStreamHandle](/fr/reference/audio/xdspaudio/handles/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) : | Code de retour | Description | | - | - | | E\_POINTER | Pointeur non valide. | | E\_INVALIDARG | Un ou plusieurs des arguments ne sont pas valides. | | XDSP\_E\_NO\_DEVICE\_RESOURCES | Aucune ressource de périphérique XDSP n'est disponible pour traiter votre demande. | | XDSP\_E\_INVALID\_IMPULSE\_RESPONSE\_LENGTH | La longueur de réponse impulsionnelle fournie n'est pas valide. Cette erreur peut se produire si une valeur [impulseResponseLengthInFloats](/fr/reference/audio/xdspaudio/structs/xdspactivationparameters) inférieure à (`9 * blockSize * 2`) ou supérieure à 16 secondes (`16 * 48000 * 2`) est fournie. | ## 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](/fr/reference/audio/xdspaudio/enums/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](/fr/reference/audio/xdspaudio/structs/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](/fr/reference/audio/xdspaudio/enums/xdspprocesstype), la longueur de la réponse impulsionnelle en floats. * Pour le type de traitement [XDspProcessType::Convolution](/fr/reference/audio/xdspaudio/enums/xdspprocesstype), la réponse impulsionnelle sous forme de valeurs dans le domaine fréquentiel. Si l'appel réussit, un [XDspStreamHandle](/fr/reference/audio/xdspaudio/handles/xdspstreamhandle) valide est renvoyé pour être utilisé avec les autres appels ([XDspSubmitCommand](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommand), [XDspSubmitCommandWithEnvelope](/fr/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope), [XDspDeactivate](/fr/reference/audio/xdspaudio/functions/xdspdeactivate)) pour ce flux. De plus, si cet appel réussit, il renvoie un pointeur vers [XDspStatus](/fr/reference/audio/xdspaudio/structs/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](/fr/reference/audio/xdspaudio/structs/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 * [Vue d'ensemble d'une convolution avec enveloppe sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope) * [Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution) * [Vue d'ensemble de XDSP](/fr/build/console-features/audio/overviews/xdsp-overview) ## Voir aussi [XDSP](/fr/reference/audio/xdspaudio/xdspaudio_members)\ [Erreurs XDSP](/fr/reference/audio/xdspaudio/enums/xdsperrors)\ [Vue d'ensemble d'une convolution sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\ [Vue d'ensemble d'une FFT/IFFT sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\ [Vue d'ensemble d'une convolution avec enveloppe sur un seul flux à l'aide de l'API XDSP](/fr/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope) ## Related topics - [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate.md) - [XDspDeactivate](/reference/audio/xdspaudio/functions/xdspdeactivate.md) - [XDSP audio](/reference/audio/xdspaudio/xdspaudio_members.md) - [XDspConnectWithMaximumStreamLimit](/reference/audio/xdspaudio/functions/xdspconnectwithmaximumstreamlimit.md) - [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect.md)