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

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

## Sintaxe

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

### Parâmetros

*handle*   \_In\_\
Tipo: XApuHandle

Identificador retornado pela chamada de [XApuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect).

### 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](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters) e fecha o identificador [XApuConnectOutputParameters::resultReadyEvent](/pt-BR/reference/audio/xapu/structs/xapuconnectoutputparameters).

Se [XApuDisconnect](/pt-BR/reference/audio/xapu/functions/xapudisconnect) 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](/pt-BR/reference/audio/xapu/enums/xapuerrors).

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

Não é recomendável chamar [XapuConnect](/pt-BR/reference/audio/xapu/functions/xapuconnect) e [XApuDisconnect](/pt-BR/reference/audio/xapu/functions/xapudisconnect) 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](/pt-BR/reference/audio/xapu/functions/xapuconnect) deve ser chamado uma vez na inicialização da sessão de streaming e, em seguida, [XApuCommandType::Activate](/pt-BR/reference/audio/xapu/enums/xapucommandtype) e [XApuCommandType::Deactivate](/pt-BR/reference/audio/xapu/enums/xapucommandtype) devem ser usados para iniciar e parar fluxos durante o streaming. No final da sessão de streaming, [XApuDisconnect](/pt-BR/reference/audio/xapu/functions/xapudisconnect) 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](/pt-BR/build/console-features/audio/overviews/xapu-overview)

## Confira também

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


## Related topics

- [XApuDisconnect](/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuConnect](/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](/reference/audio/xapu/structs/xapuconnectoutputparameters.md)