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
