> ## 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.

# XApuDisconnect

> XApuDisconnect

# XApuDisconnect

Se déconnecte du serveur matériel et libère toutes les ressources allouées lors de [XApuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect).

## Syntaxe

```cpp theme={null}
HRESULT XApuDisconnect(  
         XApuHandle handle  
)  
```

### Paramètres

*handle*   \_In\_\
Type : XApuHandle

Handle retourné par l'appel à [XApuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect).

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur.

## Remarques

En plus de se déconnecter du serveur matériel, cet appel libère également [XApuConnectOutputParameters::baseData](/fr-CA/reference/audio/xapu/structs/xapuconnectoutputparameters) et ferme le handle [XApuConnectOutputParameters::resultReadyEvent](/fr-CA/reference/audio/xapu/structs/xapuconnectoutputparameters).

Si [XApuDisconnect](/fr-CA/reference/audio/xapu/functions/xapudisconnect) est appelé avant que toutes les commandes en file d'attente soient traitées, il libère toutes les ressources et retourne le code d'erreur [XAPU\_E\_PENDING\_RESULTS](/fr-CA/reference/audio/xapu/enums/xapuerrors).

L'appelant doit attendre le résultat de la dernière commande mise en file d'attente avant d'appeler [XApuDisconnect](/fr-CA/reference/audio/xapu/functions/xapudisconnect); sinon, une défaillance catastrophique peut se produire dans le matériel, ce qui désactiverait les autres clients XAPU actifs.

Il n'est pas recommandé d'appeler [XapuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect) et [XApuDisconnect](/fr-CA/reference/audio/xapu/functions/xapudisconnect) fréquemment pour démarrer et arrêter des flux, car ces appels prennent du temps et peuvent également entraîner des pertes de ressources en raison de la fragmentation de la mémoire. Appelez plutôt [XapuConnect](/fr-CA/reference/audio/xapu/functions/xapuconnect) une seule fois lors de l'initialisation de la session de diffusion en continu, puis utilisez [XApuCommandType::Activate](/fr-CA/reference/audio/xapu/enums/xapucommandtype) et [XApuCommandType::Deactivate](/fr-CA/reference/audio/xapu/enums/xapucommandtype) pour démarrer et arrêter les flux pendant la diffusion. À la fin de la session de diffusion en continu, appelez [XApuDisconnect](/fr-CA/reference/audio/xapu/functions/xapudisconnect). Cela s'applique à tous les clients XAPU.

## Configuration requise

**En-tête :** xapu.h

**Bibliothèque :** xapu.lib

**Plateformes prises en charge :** XBOX Series X|S

## Documentation conceptuelle

* [Vue d'ensemble de XAPU](/fr-CA/build/console-features/audio/overviews/xapu-overview)

## Voir aussi

[XApuConnect](/fr-CA/reference/audio/xapu/functions/xapudisconnect)\
[XAPU](/fr-CA/reference/audio/xapu/xapu_members)


## Related topics

- [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuConnect](/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](/reference/audio/xapu/structs/xapuconnectoutputparameters.md)