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

## Sintaxis

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

### Parámetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador devuelto al llamar a [XApuConnect](https://docs.xbox.com/es/reference/audio/xapu/functions/xapuconnect.md).

### 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](https://docs.xbox.com/es/reference/audio/xapu/structs/xapuconnectoutputparameters.md) y cerrará el identificador de [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/es/reference/audio/xapu/structs/xapuconnectoutputparameters.md).

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

El autor de la llamada debe esperar el resultado del último comando puesto en cola antes de llamar a [XApuDisconnect](https://docs.xbox.com/es/reference/audio/xapu/functions/xapudisconnect.md); 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](https://docs.xbox.com/es/reference/audio/xapu/functions/xapuconnect.md) y [XApuDisconnect](https://docs.xbox.com/es/reference/audio/xapu/functions/xapudisconnect.md) 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](https://docs.xbox.com/es/reference/audio/xapu/functions/xapuconnect.md) una vez al inicializar la sesión de transmisión y, a continuación, usar [XApuCommandType::Activate](https://docs.xbox.com/es/reference/audio/xapu/enums/xapucommandtype.md) y [XApuCommandType::Deactivate](https://docs.xbox.com/es/reference/audio/xapu/enums/xapucommandtype.md) para iniciar y detener secuencias durante la transmisión. Al final de la sesión de transmisión, se debe llamar a [XApuDisconnect](https://docs.xbox.com/es/reference/audio/xapu/functions/xapudisconnect.md). 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](https://docs.xbox.com/es/build/console-features/audio/overviews/xapu-overview.md)

## Consulte también

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


## Related topics

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