Skip to main content

XApuDisconnect

中斷與硬體伺服器的連線,並釋放在 XApuConnect 期間配置的所有資源。

語法

參數

handle   _In_
類型: XApuHandle
呼叫 XApuConnect 所傳回的控制代碼。

傳回值

類型: HRESULT 如果成功,會傳回 S_OK;否則會傳回錯誤碼。

備註

除了中斷與硬體伺服器的連線之外,此呼叫也會釋放 XApuConnectOutputParameters::baseData,並關閉 XApuConnectOutputParameters::resultReadyEvent 控制代碼。 如果在處理所有已加入佇列的命令之前呼叫 XApuDisconnect,它會釋放所有資源並傳回錯誤碼 XAPU_E_PENDING_RESULTS。 呼叫端必須等候最後一個加入佇列之命令的結果,再呼叫 XApuDisconnect,否則硬體中可能會發生嚴重失敗,進而停用其他作用中的 XAPU 用戶端。 不建議經常呼叫 XapuConnect 和 XApuDisconnect 來啟動和停止串流,因為這些呼叫相當耗時,而且可能因記憶體片段化而導致資源損失。相反地,應在串流工作階段初始化時呼叫 XapuConnect 一次,然後在串流期間使用 XApuCommandType::Activate 和 XApuCommandType::Deactivate 來啟動和停止串流。在串流工作階段結束時,應呼叫 XApuDisconnect。這適用於所有 XAPU 用戶端。

需求

標頭: xapu.h 程式庫: xapu.lib 支援的平台: XBOX Series X|S

概念文件

另請參閱

XApuConnect
XAPU
Last modified on October 6, 2026