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概念文件
另請參閱
XApuConnectXAPU
