跳轉到主要內容

XGameStreamingRegisterConnectionStateChanged

註冊在串流用戶端裝置的連線狀態變更時要叫用的回呼。註冊時,將會針對所有已連線的串流用戶端裝置叫用回呼。

語法

參數

queue   _In_opt_
類型:XTaskQueueHandle
要放置變更回呼之非同步佇列的控制代碼。 context   _In_opt_
類型:void*
傳遞給回呼函式之內容的選擇性指標。 callback   _In_
類型:XGameStreamingConnectionStateChangedCallback*
任何串流用戶端裝置的連線狀態變更時將叫用的回呼函式。 token   _Out_
類型:XTaskQueueRegistrationToken*
註冊權杖的指標,可用來取消註冊事件。

傳回值

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

可能的錯誤

如需錯誤碼清單,請參閱錯誤碼。

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
建議使用此 API 讓遊戲針對每個串流用戶端裝置進行自訂,並維護狀態,讓遊戲能根據是否有任何裝置連線來最佳化體驗。
註冊時,將會針對目前已連線的所有串流用戶端裝置叫用回呼。

範例

需求

標頭: xgamestreaming.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
最後修改於 2026年10月6日