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

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

## Sintaxis

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

### 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](https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-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

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más</Note>
información, consulte [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

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](/build/core-features/common/user/player-identity-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.

<Note>Cuando se llama a esta función, todo el DLC montado previamente se</Note>
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.

<Note>Si un juego se suspende después de que se llame a **XLaunchNewGame** pero antes de que</Note>
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.

<Note>La memoria transferida al sistema mediante [XMemTransferMemory (tema NDA)](/reference/system/xmem/functions/xmemtransfermemory) se conserva.</Note>

## Requisitos

**Encabezado:** XGame.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Compatibilidad con juegos como servicio (GaaS)](/build/core-features/common/packaging/supporting-games-as-a-service)

## Consulte también

[XGame](/reference/system/xgame/xgame_members)\
[Identidad de usuario y XUser](/build/core-features/common/user/player-identity-xuser)\
[XLaunchUri](/reference/system/xlauncher/functions/xlaunchuri)


## Related topics

- [XLaunchRestartOnCrash](/es/reference/system/xgame/functions/xlaunchrestartoncrash.md)
- [Cambio del usuario predeterminado del juego](/es/build/core-features/common/user/users-changing-default-user.md)
- [XGame](/es/reference/system/xgame/xgame_members.md)
- [Compatibilidad con Games-as-a-Service (GaaS)](/es/build/core-features/common/packaging/supporting-games-as-a-service.md)
- [Usuarios y dispositivos de entrada](/es/build/core-features/common/user/users-input-devices.md)