Skip to main content

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 主機

另請參閱

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