Skip to main content

XGameStreamingRegisterClientPropertiesChanged

註冊在任何串流用戶端裝置的屬性變更時要叫用的回呼。
註冊時,將會針對用戶端裝置目前的用戶端屬性叫用回呼。

語法

參數

client   _In_
類型:XGameStreamingClientId
您要註冊以取得其回呼之遊戲串流用戶端的識別碼。 queue   _In_opt_
類型:XTaskQueueHandle
要放置變更回呼之非同步佇列的控制代碼。 context   _In_opt_
類型:void*
選擇性的內容指標,將傳遞給回呼函式。 callback   _In_
類型:XGameStreamingClientPropertiesChangedCallback*
用戶端屬性變更時將叫用的回呼函式。 token   _Out_
類型:XTaskQueueRegistrationToken*
註冊權杖的指標,可用來取消註冊事件。

傳回值

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

可能的錯誤

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

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
此 API 可讓遊戲在 XGameStreamingClientProperty (例如串流實體尺寸) 變更時,接收 XGameStreamingClientPropertiesChangedCallback。 註冊將會使回呼以所有適用的 XGameStreamingClientProperty 叫用,以便查詢目前的屬性詳細資料。 當串流用戶端裝置中斷連線時,請使用 XGameStreamingUnregisterClientPropertiesChanged 取消註冊回呼。

範例

需求

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

概念文件

另請參閱

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
Last modified on October 6, 2026