> ## 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.

# XLaunchNewGame

> XLaunchNewGame

# XLaunchNewGame

Met fin au jeu en cours, libère toutes les ressources allouées et lance un nouveau jeu.

## Syntaxe

```cpp theme={null}
void XLaunchNewGame(  
         const char* exePath,  
         const char* args,  
         XUserHandle defaultUser  
)  
```

### Paramètres

*exePath*   \_In\_z\_\
Type : char\*

Chemin d'accès et nom de fichier du nouveau jeu à lancer. Ce chemin peut être relatif au répertoire actif ou absolu. Les jeux qui ont besoin de connaître le chemin de l'exécutable appelant peuvent appeler [GetModuleFileNameA](https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulefilenamea) avec nullptr comme handle de module.

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

Arguments applicables propres au jeu avec lesquels lancer le nouveau jeu.

*defaultUser*   \_In\_opt\_\
Type : XUserHandle

Handle de l'utilisateur qui lance le nouveau jeu. Si aucune valeur n'est spécifiée, l'utilisateur actuel est
utilisé.

### Valeur de retour

Type : void

Cette fonction ne retourne aucune valeur et ne lève aucune exception, même si elle ne parvient pas à redémarrer le jeu.

## Remarques

<Note>Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus</Note>
d'informations, consultez [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

Cette fonction redémarre le jeu : elle met fin au processus actuel du jeu et redémarre le jeu dans un
nouveau processus. Le jeu est redémarré sans redémarrer la machine virtuelle sur laquelle il
s'exécute. Vous pouvez spécifier un autre utilisateur par défaut et des arguments propres au jeu avec
lesquels le jeu doit être redémarré ; pour plus d'informations sur la spécification d'un autre utilisateur par défaut, consultez [Identité de
l'utilisateur et XUser](/fr/build/core-features/common/user/player-identity-xuser).

Le processus actuel est toujours arrêté, même si la fonction rencontre une erreur lors du lancement d'un
nouveau jeu. Par exemple, si une valeur spécifiée pour *exePath*, *args* ou *defaultUser* n'est pas valide,
la fonction ne retourne aucune valeur et ne lève aucune exception.

<Note>Lorsque cette fonction est appelée, tous les DLC précédemment montés sont</Note>
démontés, à l'exception du DLC qui héberge la cible de **XLaunchNewGame**. Le lecteur **G:**
continue de pointer vers la racine du package de base et non vers l'EXE nouvellement lancé.

<Note>Si un jeu est suspendu après l'appel de **XLaunchNewGame**, mais avant que</Note>
le jeu nouvellement lancé ait configuré son gestionnaire de suspension, le jeu est arrêté. Il s'agit d'une
fenêtre de temps très étroite et, en pratique, cette situation devrait être très peu probable.

<Note>La mémoire transférée au système à l'aide de [XMemTransferMemory (rubrique sous NDA)](/fr/reference/system/xmem/functions/xmemtransfermemory) est conservée.</Note>

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Prise en charge des jeux en tant que service (GaaS)](/fr/build/core-features/common/packaging/supporting-games-as-a-service)

## Voir aussi

[XGame](/fr/reference/system/xgame/xgame_members)\
[Identité de l'utilisateur et XUser](/fr/build/core-features/common/user/player-identity-xuser)\
[XLaunchUri](/fr/reference/system/xlauncher/functions/xlaunchuri)


## Related topics

- [XLaunchNewGame](/reference/system/xgame/functions/xlaunchnewgame.md)
- [XLaunchRestartOnCrash](/reference/system/xgame/functions/xlaunchrestartoncrash.md)
- [XGame](/reference/system/xgame/xgame_members.md)