Skip to main content

XGameStreamingUpdateTouchControlsStateOnClient

在指定的串流用戶端上更新觸控配置可用來改變其行為的狀態。目前顯示的觸控控制項組合的任何視覺變更,都會在「所有」變數更新之後才進行。

語法

參數

client   _In_
類型:XGameStreamingClientId
要在其上更新狀態的串流用戶端裝置。 operationCount   _In_
類型:size_t
所傳遞之作業陣列的大小 operations   _In_reads_opt_(operationCount)
類型:XGameStreamingTouchControlsStateOperation*
所有要求之狀態變數更新的陣列。

傳回值

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

可能的錯誤

備註

串流用戶端使用的觸控配置可以相依於狀態,而狀態的初始值內嵌於觸控配置套件組合中。遊戲可以更新狀態,進而使目前向玩家顯示的配置產生變更。 遊戲可以使用 XGameStreamingUpdateTouchControlsState 更新所有已連線用戶端的狀態,或使用 XGameStreamingUpdateTouchControlsStateOnClient 更新特定已連線用戶端的狀態。 如果遊戲想要同時更新狀態「並」變更配置,可以使用 XGameStreamingShowTouchControlsWithStateUpdate 或 XGameStreamingShowTouchControlsWithStateUpdateOnClient。

範例

需求

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

另請參閱

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdate
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
Last modified on October 6, 2026