> ## 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. # XDspConnect > XDspConnect # XDspConnect Établit une connexion avec le serveur matériel, crée une instance de client XDSP et alloue les ressources nécessaires au traitement. Il existe une limite globale de 8 clients XDSP actifs simultanément. ## Syntaxe ```cpp theme={null} HRESULT XDspConnect( float* baseBuffer, uint32_t baseBufferLength, uint32_t aggregateImpulseResponseInSeconds, XDspClientHandle* handle ) ``` ### Paramètres *baseBuffer*   \_In\_\ Type : float\* Mémoire tampon contiguë allouée par un appelant XDSP pour transmettre les données d'entrée et récupérer les données de sortie. Pour plus de détails, consultez la section **Remarques** ci-dessous. *baseBufferLength*   \_In\_\ Type : uint32\_t Longueur de *baseBuffer*, en octets. Cette longueur doit être d'au moins 64 Ko et d'au plus 500 Mo. *aggregateImpulseResponseInSeconds*   \_In\_\ Type : uint32\_t Représente la durée globale de toutes les réponses impulsionnelles individuelles qui seront activées simultanément sur ce client. *aggregateImpulseResponseInSeconds* doit être défini sur une valeur supérieure à zéro pour [XDspProcessType::Convolution](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype); sinon, il doit être égal à zéro. Il existe une limite globale de 128 secondes de réponse impulsionnelle agrégée pour l'ensemble des clients XDSP. *handle*   \_Outptr\_\ Type : [XDspClientHandle\*](/fr-CA/reference/audio/xdspaudio/handles/xdspclienthandle) Handle vers un client XDSP qui doit être utilisé pour activer des flux au moyen de [XDspActivate](/fr-CA/reference/audio/xdspaudio/functions/xdspactivate) et pour déconnecter le client du serveur matériel au moyen de [XDspDisconnect](/fr-CA/reference/audio/xdspaudio/functions/xdspdisconnect). Un maximum de 256 flux peuvent être actifs à tout moment pour l'ensemble des XDSPClientHandles. ### 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\_INVALIDARG | Un ou plusieurs des arguments ne sont pas valides. | | E\_OUTOFMEMORY | L'allocation de mémoire a échoué. | | XDSP\_E\_MAX\_CLIENTS\_EXCEEDED | Le nombre maximal de XDspClients a déjà été créé. | | XDSP\_E\_MAX\_AGGREGATE\_IMPULSE\_RESPONSE\_EXCEEDED | L'appel actuel à [XDspConnect](/fr-CA/reference/audio/xdspaudio/functions/xdspconnect) entraînera le dépassement par XDSP de la longueur maximale de réponse impulsionnelle agrégée prise en charge, et n'est donc pas valide. | ## Remarques Si l'appel réussit, l'appelant peut utiliser *baseBuffer* pour transmettre les données d'entrée et récupérer les données de sortie du flux au moyen des paramètres de [XDspCommand](/fr-CA/reference/audio/xdspaudio/structs/xdspcommand). Si l'enveloppe est utilisée, cette mémoire tampon doit également tenir compte des mémoires tampons servant à stocker les paramètres d'enveloppe. Consultez [Vue d'ensemble de l'enveloppe à l'aide de l'API XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-enveloping) pour plus d'informations sur l'enveloppe. Cette fonction doit être appelée avant l'activation des flux XDSP afin d'inscrire un grand bloc de mémoire suffisant pour contenir plusieurs flux audio complets utilisés en entrée, plusieurs mémoires tampons de sortie pour tous les flux XDSP qui seront activés au moyen de [XDspActivate](/fr-CA/reference/audio/xdspaudio/functions/xdspactivate), ainsi que plusieurs mémoires tampons de multiplicateurs de blocs qui peuvent être utilisées dans le cadre de [XDspCommand](/fr-CA/reference/audio/xdspaudio/structs/xdspcommand) pour le type de traitement [XDspProcessType::ForwardFourierTransform](/fr-CA/reference/audio/xdspaudio/enums/xdspprocesstype). Tenez compte des exigences de taille minimale et maximale de cette mémoire tampon, indiquées ci-dessus. Si cet appel réussit, tous les flux XDSP peuvent accéder à n'importe quelle partie de ce bloc de mémoire. Cette mémoire doit être allouée au moyen de XMemAlloc() avec les attributs suivants : **XALLOC\_MEMTYPE\_PHYSICAL\_CACHEABLE**, **XALLOC\_PAGESIZE\_64KB**, **XALLOC\_ALIGNMENT\_64K** Ces attributs doivent être définis à l'aide de **MAKE\_XALLOC\_ATTRIBUTES()**. En voici un exemple : ```cpp theme={null} static const ULONGLONG XMemAllocAttributes = MAKE_XALLOC_ATTRIBUTES(allocatorId, 0, XALLOC_MEMTYPE_PHYSICAL_CACHEABLE, XALLOC_PAGESIZE_64KB, XALLOC_ALIGNMENT_64K, FALSE); ``` Dans l'exemple ci-dessus, *allocatorId* doit être remplacé par l'ID d'allocateur correct utilisé par le titre. Il incombe à l'appelant de partitionner et de recycler *baseBuffer* pour contenir différents flux d'entrée et mémoires tampons de sortie pour plusieurs flux. *impulseResponse* n'a pas besoin de provenir de ce *baseBuffer* et peut provenir de n'importe quelle mémoire allouée par l'appelant. La mémoire pointée par *baseBuffer* ne doit pas être libérée tant que [XDspConnect](/fr-CA/reference/audio/xdspaudio/functions/xdspconnect) n'a pas été appelée. Tous les pointeurs de mémoire transmis à l'[API XDSP](/fr-CA/reference/audio/xdspaudio/xdspaudio_members) doivent être alignés sur 16 octets. Si l'appel réussit, un [XDspClientHandle](/fr-CA/reference/audio/xdspaudio/handles/xdspclienthandle) valide sera retourné pour être utilisé avec les appels à [XDspActivate](/fr-CA/reference/audio/xdspaudio/functions/xdspactivate) et à [XDspDisconnect](/fr-CA/reference/audio/xdspaudio/functions/xdspdisconnect). ## Configuration requise **En-tête :** XDspAudio.h **Bibliothèque :** Chad.lib **Plateformes prises en charge :** XBOX Series X|S ## Documentation conceptuelle * [Vue d'ensemble de l'enveloppe XDSP](/fr-CA/build/console-features/audio/overviews/xdsp-overview-enveloping) * [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)\ [XDspConnectWithMaximumStreamLimit](/fr-CA/reference/audio/xdspaudio/functions/xdspconnectwithmaximumstreamlimit)\ [XDspDisconnect](/fr-CA/reference/audio/xdspaudio/functions/xdspdisconnect)\ [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 - [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect.md) - [XDspConnectWithMaximumStreamLimit](/reference/audio/xdspaudio/functions/xdspconnectwithmaximumstreamlimit.md)