Skip to main content

​
XLaunchNewGame

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

​
Syntaxe

​
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 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

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus
d’informations, consultez Threads à durée critique. 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. 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.
Lorsque cette fonction est appelée, tous les DLC précédemment montés sont
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é.
Si un jeu est suspendu après l’appel de XLaunchNewGame, mais avant que
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.
La mémoire transférée au système à l’aide de XMemTransferMemory (rubrique sous NDA) est conservée.

​
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

​
Voir aussi

XGame
Identité de l’utilisateur et XUser
XLaunchUri
Last modified on October 6, 2026