XGameStreamingShowTouchControlsWithStateUpdate
要求所有已連線的串流用戶端裝置更新其觸控控制項狀態,並顯示指定的觸控配置。所有狀態更新都會在顯示新的觸控配置之前完成。語法
參數
layout _In_opt_z_類型:char* 要顯示的觸控控制項配置名稱,或使用
nullptr 以顯示標準配置。
operationCount _In_類型:size_t 所傳遞之作業陣列的大小 operations _In_reads_opt_(operationCount)
類型:XGameStreamingTouchControlsStateOperation* 所有要求之狀態變數更新的陣列
傳回值
類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。可能的錯誤
備註
當遊戲需要顯示特定的觸控配置,而該配置也需要某些可能影響其轉譯的狀態更新時,應使用此 API。如果您想要同時更新新觸控配置中所參考之變數的狀態,並在所有已連線的串流用戶端裝置上切換至該觸控配置,請使用此 API。此 API 可確保所有狀態更新都在顯示新配置之前完成。 如果您只想影響特定用戶端,請使用 XGameStreamingShowTouchControlsWithStateUpdateOnClient。 如果遊戲只想變更配置,則應改用 XGameStreamingShowTouchControlLayout。 如果狀態更新可能會影響目前的配置或其他配置,而且無論是否有特定的觸控配置變更都應進行更新,則遊戲應改用 XGameStreamingUpdateTouchControlsState。範例
需求
標頭: XGameStreaming.h 程式庫: xgameruntime.lib支援的平台:Windows、XBOX One 系列主機和 XBOX Series 主機
另請參閱
XGameStreamingXGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
