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

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

## 語法

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

### 參數

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

呼叫 [XApuConnect](/zh-TW/reference/audio/xapu/functions/xapuconnect) 所傳回的控制代碼。

### 傳回值

類型: HRESULT

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

## 備註

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

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

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

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

## 需求

**標頭:** xapu.h

**程式庫:** xapu.lib

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

## 概念文件

* [XAPU 概觀](/zh-TW/build/console-features/audio/overviews/xapu-overview)

## 另請參閱

[XApuConnect](/zh-TW/reference/audio/xapu/functions/xapudisconnect)\
[XAPU](/zh-TW/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)