> ## 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 streaming 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 streaming. 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/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 est affiché.

Toute chaîne qui ne correspond pas à un ID de disposition de commandes tactiles du titre ne modifie 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 streaming 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 streaming, ou s'il le diffuse sur un appareil où l'entrée tactile n'est pas activée, cette fonction ne fait rien.

Si le joueur utilise une manette physique au lieu des commandes tactiles, cette fonction ne force pas l'apparition 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 donnée à 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étermine 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 ; il ne doit donc pas être appelé à chaque frame. 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é lors de l'appel à `XGameStreamingShowTouchControlLayout`, le client qui se connectera recevra la dernière disposition de commandes tactiles demandée.

Si votre jeu souhaite afficher la disposition des commandes tactiles sur **un appareil client de streaming connecté spécifique**, envisagez plutôt d'utiliser [XGameStreamingShowTouchControlLayoutOnClient](/fr/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/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols)\
[XGameStreamingShowTouchControlLayoutOnClient](/fr/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient)\
[XGameStreaming](/fr/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)