> ## 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/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/reference/audio/xapu/functions/xapuconnect).

### Valeur renvoyée

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/reference/audio/xapu/structs/xapuconnectoutputparameters) et ferme le handle [XApuConnectOutputParameters::resultReadyEvent](/fr/reference/audio/xapu/structs/xapuconnectoutputparameters).

Si [XApuDisconnect](/fr/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/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/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 fréquemment [XapuConnect](/fr/reference/audio/xapu/functions/xapuconnect) et [XApuDisconnect](/fr/reference/audio/xapu/functions/xapudisconnect) pour démarrer et arrêter des flux, car ces appels sont coûteux en temps et peuvent également entraîner des pertes de ressources dues à la fragmentation de la mémoire. [XapuConnect](/fr/reference/audio/xapu/functions/xapuconnect) doit plutôt être appelé une seule fois lors de l'initialisation de la session de streaming, puis [XApuCommandType::Activate](/fr/reference/audio/xapu/enums/xapucommandtype) et [XApuCommandType::Deactivate](/fr/reference/audio/xapu/enums/xapucommandtype) doivent être utilisés pour démarrer et arrêter des flux pendant le streaming. À la fin de la session de streaming, [XApuDisconnect](/fr/reference/audio/xapu/functions/xapudisconnect) doit être appelé. 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/build/console-features/audio/overviews/xapu-overview)

## Voir aussi

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


## Related topics

- [XApuConnect](/fr/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](/fr/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [Décodage audio Opus à flux unique avec l'API XAPU](/fr/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](/fr/reference/audio/xapu/xapu_members.md)
- [Vue d'ensemble de XAPU](/fr/build/console-features/audio/overviews/xapu-overview.md)