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 et nom de fichier du nouveau jeu à lancer. Ce chemin peut être relatif au répertoire actuel ou absolu. Les jeux qui doivent 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

Il n’est pas sécuritaire d’appeler cette fonction sur un thread urgent. Pour plus
d’informations, consultez Threads urgents. 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 redémarrer le jeu; pour plus de détails 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, tout le contenu téléchargeable (DLC) précédemment monté sera
démonté, à l’exception du DLC qui héberge la cible de XLaunchNewGame. Le lecteur G: continuera de pointer vers la racine du package de base et non vers le nouvel EXE 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 sera arrêté. Il s’agit d’un intervalle de temps très court 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