> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapuconnect.md).

## Syntaxe

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

### Paramètres

*handle*   \_In\_\
Type : XApuHandle

Handle retourné par l'appel à [XApuConnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapuconnect.md).

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

Si [XApuDisconnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapudisconnect.md) 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](https://docs.xbox.com/fr/reference/audio/xapu/enums/xapuerrors.md).

L'appelant doit attendre le résultat de la dernière commande mise en file d'attente avant d'appeler [XApuDisconnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapudisconnect.md) ; 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](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapuconnect.md) et [XApuDisconnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapudisconnect.md) 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](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapuconnect.md) doit plutôt être appelé une seule fois lors de l'initialisation de la session de streaming, puis [XApuCommandType::Activate](https://docs.xbox.com/fr/reference/audio/xapu/enums/xapucommandtype.md) et [XApuCommandType::Deactivate](https://docs.xbox.com/fr/reference/audio/xapu/enums/xapucommandtype.md) doivent être utilisés pour démarrer et arrêter des flux pendant le streaming. À la fin de la session de streaming, [XApuDisconnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapudisconnect.md) 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](https://docs.xbox.com/fr/build/console-features/audio/overviews/xapu-overview.md)

## Voir aussi

[XApuConnect](https://docs.xbox.com/fr/reference/audio/xapu/functions/xapudisconnect.md)\
[XAPU](https://docs.xbox.com/fr/reference/audio/xapu/xapu_members.md)


## Related topics

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