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

中斷與硬體伺服器的連線，並釋放在 [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 期間配置的所有資源。

## 語法

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

### 參數

*handle*   \_In\_\
類型: XApuHandle

呼叫 [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 所傳回的控制代碼。

### 傳回值

類型: HRESULT

如果成功，會傳回 `S_OK`；否則會傳回錯誤碼。

## 備註

除了中斷與硬體伺服器的連線之外，此呼叫也會釋放 [XApuConnectOutputParameters::baseData](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters.md)，並關閉 [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters.md) 控制代碼。

如果在處理所有已加入佇列的命令之前呼叫 [XApuDisconnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudisconnect.md)，它會釋放所有資源並傳回錯誤碼 [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuerrors.md)。

呼叫端必須等候最後一個加入佇列之命令的結果，再呼叫 [XApuDisconnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudisconnect.md)，否則硬體中可能會發生嚴重失敗，進而停用其他作用中的 XAPU 用戶端。

不建議經常呼叫 [XapuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 和 [XApuDisconnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudisconnect.md) 來啟動和停止串流，因為這些呼叫相當耗時，而且可能因記憶體片段化而導致資源損失。相反地，應在串流工作階段初始化時呼叫 [XapuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 一次，然後在串流期間使用 [XApuCommandType::Activate](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapucommandtype.md) 和 [XApuCommandType::Deactivate](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapucommandtype.md) 來啟動和停止串流。在串流工作階段結束時，應呼叫 [XApuDisconnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapudisconnect.md)。這適用於所有 XAPU 用戶端。

## 需求

**標頭:** xapu.h

**程式庫:** xapu.lib

**支援的平台:** XBOX Series X|S

## 概念文件

* [XAPU 概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xapu-overview.md)

## 另請參閱

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


## Related topics

- [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [使用 XAPU API 進行單一串流 Opus 音訊解碼](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](https://docs.xbox.com/zh-TW/reference/audio/xapu/xapu_members.md)
- [XAPU 概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xapu-overview.md)