> ## 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 desconecta del servidor de hardware y libera todos los recursos asignados durante [XApuConnect](/reference/audio/xapu/functions/xapuconnect).

## Sintaxis

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

### Parámetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador devuelto al llamar a [XApuConnect](/reference/audio/xapu/functions/xapuconnect).

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error.

## Comentarios

Además de desconectarse del servidor de hardware, esta llamada también liberará [XApuConnectOutputParameters::baseData](/reference/audio/xapu/structs/xapuconnectoutputparameters) y cerrará el identificador de [XApuConnectOutputParameters::resultReadyEvent](/reference/audio/xapu/structs/xapuconnectoutputparameters).

Si se llama a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect) antes de que se procesen todos los comandos en cola, liberará todos los recursos y devolverá este código de error [XAPU\_E\_PENDING\_RESULTS](/reference/audio/xapu/enums/xapuerrors).

El autor de la llamada debe esperar el resultado del último comando puesto en cola antes de llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect); de lo contrario, podría producirse un error catastrófico en el hardware que deshabilitaría otros clientes de XAPU activos.

No se recomienda llamar a [XapuConnect](/reference/audio/xapu/functions/xapuconnect) y [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect) con frecuencia para iniciar y detener secuencias, ya que esas llamadas consumen mucho tiempo y también podrían provocar pérdidas de recursos debido a la fragmentación de la memoria. En su lugar, se debe llamar a [XapuConnect](/reference/audio/xapu/functions/xapuconnect) una vez al inicializar la sesión de transmisión y, a continuación, usar [XApuCommandType::Activate](/reference/audio/xapu/enums/xapucommandtype) y [XApuCommandType::Deactivate](/reference/audio/xapu/enums/xapucommandtype) para iniciar y detener secuencias durante la transmisión. Al final de la sesión de transmisión, se debe llamar a [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect). Esto se aplica a todos los clientes de XAPU.

## Requisitos

**Encabezado:** xapu.h

**Biblioteca:** xapu.lib

**Plataformas compatibles:** XBOX Series X|S

## Documentación conceptual

* [Información general de XAPU](/build/console-features/audio/overviews/xapu-overview)

## Consulte también

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


## Related topics

- [XApuConnect](/es/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](/es/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [Descodificación de audio Opus de una sola secuencia con la API XAPU](/es/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](/es/reference/audio/xapu/xapu_members.md)
- [Información general sobre XAPU](/es/build/console-features/audio/overviews/xapu-overview.md)