> ## 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 acquérant 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-CA/reference/audio/xdspaudio/handles/xdspclienthandle) Handle de client XDSP valide obtenu à partir de l'appel à XDspConnect. *params*   \_In\_\ Type : [XDspActivationParameters\*](/fr-CA/reference/audio/xdspaudio/structs/xdspactivationparameters) Pointeur vers une structure [XDspActivationParameters](/fr-CA/reference/audio/xdspaudio/structs/xdspactivationparameters). *status*   \_Outptr\_\ Type : [XDspStatus\*\*](/fr-CA/reference/audio/xdspaudio/structs/xdspstatus) Pointeur vers une structure [XDspStatus](/fr-CA/reference/audio/xdspaudio/structs/xdspstatus). Consultez la section **Remarques** pour plus de détails. *streamHandle*   \_Outptr\_\ Type : [XDspStreamHandle\*](/fr-CA/reference/audio/xdspaudio/handles/xdspstreamhandle) [XDspStreamHandle](/fr-CA/reference/audio/xdspaudio/handles/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) : | 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-CA/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 acquiert des ressources dans le pool au lieu de les allouer. L'appelant doit spécifier un [XDspProcessType](/fr-CA/reference/audio/xdspaudio/enums/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](/fr-CA/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.-à-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](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype), la longueur de la réponse impulsionnelle en nombres à virgule flottante. * Pour le type de traitement [XDspProcessType::Convolution](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype), la réponse impulsionnelle sous forme de valeurs du domaine fréquentiel. Si l'appel réussit, un [XDspStreamHandle](/fr-CA/reference/audio/xdspaudio/handles/xdspstreamhandle) valide sera retourné pour être utilisé avec d'autres appels ([XDspSubmitCommand](/fr-CA/reference/audio/xdspaudio/functions/xdspsubmitcommand), [XDspSubmitCommandWithEnvelope](/fr-CA/reference/audio/xdspaudio/functions/xdspsubmitcommandwithenvelope), [XDspDeactivate](/fr-CA/reference/audio/xdspaudio/functions/xdspdeactivate)) pour ce flux. De plus, si cet appel réussit, il retournera un pointeur vers [XDspStatus](/fr-CA/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-CA/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 à flux unique avec enveloppe à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope) * [Vue d'ensemble d'une convolution à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution) * [Vue d'ensemble de XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview) ## Voir aussi [XDSP](/fr-CA/reference/audio/xdspaudio/xdspaudio_members)\ [Erreurs XDSP](/fr-CA/reference/audio/xdspaudio/enums/xdsperrors)\ [Vue d'ensemble d'une convolution à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\ [Vue d'ensemble d'une FFT/IFFT à flux unique à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)\ [Vue d'ensemble d'une convolution à flux unique avec enveloppe à l'aide de l'API XDSP](/fr-CA/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)