Skip to main content

XGameStreamingShowTouchControlLayoutOnClient

Shows the requested set of Touch controls on a single client.

Syntax

Parameters

client   _In_
Type: XGameStreamingClientId
The streaming client device show the touch controls on. layout   _In_opt_z_
Type: char*
Name of the touch control layout to display or nullptr to display the default layout. The id of the touch control layout which should be displayed on the streaming client device. Layout ids are title-specific, and correspond to the ids of the layouts which are provided to XBOX Game Streaming as part of the Touch Adaptation Kit. This string is expected to be UTF-8 encoded. If nullptr is provided, the default set of touch controls will be shown. Any string which does not correspond to a touch control layout id for the title will not change the state of the touch controls on the client device to remain unchanged. The Content Test Application may provide a diagnostic in these cases.

Return Value

Type: void

Remarks

This API requests that the specified game streaming client displays a specific touch control layout on the player’s client device. If the player is not streaming the game, or if the streaming client does not have touch enabled, this function does nothing. If the player is using a physical controller instead of using touch controls, this function will not force touch controls to appear on their device. Instead, the client will use the last layout requested the next time that the player starts using touch controls. You can think of this function as a hint to the client device, which tells it which touch control layout is most appropriate for the current game state if the player is using touch controls. The client device will then manage when it is best to put those controls on the player’s screen. Every call to XGameStreamingShowTouchControlLayoutOnClient results in a message being sent over the network, so it should not be called every frame. Instead, only call this API when your game needs to transition between different touch control layouts. If your game would like to show the touch control layout on all connected streaming client device, consider using XGameStreamingShowTouchControlLayout instead.

Examples

Requirements

Header: xgamestreaming.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

XGameStreamingHideTouchControlsOnClient
XGameStreamingShowTouchControlLayout
XGameStreaming
Last modified on August 20, 2026