Skip to main content

​
XLaunchNewGame

Finaliza el juego actual, libera los recursos asignados e inicia un juego nuevo.

​
Sintaxis

​
Parámetros

exePath   _In_z_
Tipo: char* La ruta de acceso y el nombre de archivo del nuevo juego que se va a iniciar. Esta ruta puede ser relativa al directorio actual o una ruta absoluta. Los juegos que necesiten conocer la ruta del ejecutable que realiza la llamada pueden llamar a GetModuleFileNameA con un nullptr como identificador de módulo. args   _In_opt_z_
Tipo: char* Los argumentos aplicables específicos del juego con los que se debe iniciar el nuevo juego. defaultUser   _In_opt_
Tipo: XUserHandle El identificador del usuario que inicia el nuevo juego. Si no se especifica un valor, se especifica el usuario actual.

​
Valor devuelto

Tipo: void Esta función no devuelve un valor ni genera excepciones, incluso si no puede reiniciar el juego.

​
Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más
información, consulte Subprocesos sensibles al tiempo. Esta función reinicia el juego, finaliza el proceso actual del juego y lo reinicia usando un proceso nuevo. El juego se reinicia sin reiniciar la máquina virtual en la que se está ejecutando. Tiene la opción de especificar un usuario predeterminado diferente y argumentos específicos del juego con los que se debe reiniciar el juego; para obtener detalles sobre cómo especificar un usuario predeterminado diferente, consulte Identidad de usuario y XUser. El proceso actual siempre se termina, incluso si la función encuentra un error al iniciar un juego nuevo. Por ejemplo, si algún valor especificado para exePath, args o defaultUser no es válido, la función no devuelve un valor ni genera una excepción.
Cuando se llama a esta función, todo el DLC montado previamente se
desmonta, con la excepción del DLC que hospeda el destino de XLaunchNewGame. La unidad G: seguirá apuntando a la raíz del paquete base y no al EXE recién iniciado.
Si un juego se suspende después de que se llame a XLaunchNewGame pero antes de que
el juego recién iniciado configure su controlador de suspensión, el juego se terminará. Se trata de una ventana de tiempo muy estrecha y, en la práctica, debería ser un caso muy poco probable.
La memoria transferida al sistema mediante XMemTransferMemory (tema NDA) se conserva.

​
Requisitos

Encabezado: XGame.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

​
Documentación conceptual

​
Consulte también

XGame
Identidad de usuario y XUser
XLaunchUri
Última modificación el 28 de agosto de 2026

Temas relacionados

XLaunchRestartOnCrashCambio del usuario predeterminado del juegoXGameCompatibilidad con Games-as-a-Service (GaaS)Usuarios y dispositivos de entrada