> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameStreamingShowTouchControlLayout

> XGameStreamingShowTouchControlLayout

# XGameStreamingShowTouchControlLayout

Demande à tous les appareils clients de diffusion en continu connectés d'afficher une disposition tactile spécifiée.

## Syntaxe

```cpp theme={null}
void XGameStreamingShowTouchControlLayout(
         const char* layout  
)  
```

## Paramètres

*layout*   \_In\_opt\_z\_\
Type : char\*

Nom de la disposition des commandes tactiles à afficher, ou `nullptr` pour afficher la disposition standard de la manette XBOX.

ID de la disposition des commandes tactiles qui doit être affichée sur l'appareil client de diffusion en continu. Les ID de disposition sont propres au titre et correspondent aux ID des dispositions fournies au service XBOX Game Streaming dans le cadre du [Touch Adaptation Kit](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview). Cette chaîne doit être encodée en UTF-8.

Si `nullptr` est fourni, l'ensemble par défaut de commandes tactiles sera affiché.

Toute chaîne qui ne correspond pas à un ID de disposition des commandes tactiles du titre ne modifiera pas l'état des commandes tactiles sur l'appareil client. L'application Content Test Application peut fournir un diagnostic dans ces cas.

## Valeur de retour

Type : void

## Remarques

Cette API demande à tous les clients de diffusion en continu de jeu actuels d'afficher une disposition de commandes tactiles spécifique sur l'appareil client du joueur. Si le joueur ne diffuse pas le jeu en continu, ou s'il le diffuse vers un appareil qui ne prend pas en charge le tactile, cette fonction ne fait rien.

Si le joueur utilise une manette physique plutôt que les commandes tactiles, cette fonction ne forcera pas l'affichage des commandes tactiles sur son appareil. Le client utilisera plutôt la dernière disposition demandée la prochaine fois que le joueur commencera à utiliser les commandes tactiles.

Vous pouvez considérer cette fonction comme une indication à l'appareil client, qui lui indique quelle disposition de commandes tactiles est la plus appropriée pour l'état actuel du jeu si le joueur utilise les commandes tactiles. L'appareil client déterminera ensuite le meilleur moment pour afficher ces commandes à l'écran du joueur.

Chaque appel à `XGameStreamingShowTouchControlLayout` entraîne l'envoi d'un message sur le réseau; cette fonction ne doit donc pas être appelée à chaque image. Appelez plutôt cette API uniquement lorsque votre jeu doit passer d'une disposition de commandes tactiles à une autre.

Si aucun appareil client n'est connecté lorsque `XGameStreamingShowTouchControlLayout` est appelée, un client qui se connecte par la suite recevra la disposition de commandes tactiles demandée le plus récemment.

Si votre jeu souhaite afficher la disposition des commandes tactiles sur **un appareil client précis** de diffusion en continu connecté, envisagez plutôt d'utiliser [XGameStreamingShowTouchControlLayoutOnClient](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient).

## Exemples

```C++ theme={null}
void OnGameStateChanged(GameState newState)
{
    // Toggle to the set of touch overlay controls which best match the new state of the game
    switch (newState)
    {
    case GameState::FirstPersonAction:
        XGameStreamingShowTouchControlLayout("FirstPersonAction");
        break;
    case GameState::Driving:
        XGameStreamingShowTouchControlLayout("Driving");
        break;
    case GameState::CutScene:
        // Don't show any touch overlay controls while the cut scene is rendering
        XGameStreamingHideTouchControls();
        break;
    }
}
```

## Configuration requise

**En-tête :** xgamestreaming.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[XGameStreamingHideTouchControls](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols)\
[XGameStreamingShowTouchControlLayoutOnClient](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient)\
[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members#TouchAdaptation)


## Related topics

- [XGameStreamingShowTouchControlLayout](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)
- [XGameStreamingShowTouchControlLayoutOnClient](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient.md)
- [Changing Touch Control Layouts Based On Game State](/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state.md)
- [XGameStreamingShowTouchControlsWithStateUpdate](/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate.md)
- [XGameStreamingHideTouchControls](/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols.md)