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

Desconecta-se do servidor de hardware e libera todos os recursos alocados durante [XApuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md).

## Sintaxe

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

### Parâmetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador retornado pela chamada de [XApuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md).

### Valor retornado

Tipo: HRESULT

Retornará `S_OK` se tiver êxito; caso contrário, retornará um código de erro.

## Comentários

Além de desconectar do servidor de hardware, essa chamada também libera [XApuConnectOutputParameters::baseData](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md) e fecha o identificador [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md).

Se [XApuDisconnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapudisconnect.md) for chamado antes que todos os comandos enfileirados sejam processados, ele liberará todos os recursos e retornará o código de erro [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapuerrors.md).

O chamador deve aguardar o resultado do último comando enfileirado antes de chamar [XApuDisconnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapudisconnect.md); caso contrário, poderá ocorrer uma falha catastrófica no hardware, o que desabilitará outros clientes XAPU ativos.

Não é recomendável chamar [XapuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md) e [XApuDisconnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapudisconnect.md) com frequência para iniciar e parar fluxos, pois essas chamadas são demoradas e também podem levar a perdas de recursos devido à fragmentação da memória. Em vez disso, [XapuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md) deve ser chamado uma vez na inicialização da sessão de streaming e, em seguida, [XApuCommandType::Activate](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandtype.md) e [XApuCommandType::Deactivate](https://docs.xbox.com/pt-BR/reference/audio/xapu/enums/xapucommandtype.md) devem ser usados para iniciar e parar fluxos durante o streaming. No final da sessão de streaming, [XApuDisconnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapudisconnect.md) deve ser chamado. Isso vale para todos os clientes XAPU.

## Requisitos

**Cabeçalho:** xapu.h

**Biblioteca:** xapu.lib

**Plataformas compatíveis:** XBOX Series X|S

## Documentação conceitual

* [Visão geral do XAPU](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xapu-overview.md)

## Confira também

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


## Related topics

- [XApuConnect](https://docs.xbox.com/pt-BR/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [Decodificação de áudio Opus de fluxo único com a API XAPU](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](https://docs.xbox.com/pt-BR/reference/audio/xapu/xapu_members.md)
- [Visão geral da XAPU](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/xapu-overview.md)