Skip to main content

​
XLaunchNewGame

Encerra o jogo atual, libera todos os recursos alocados e inicia um novo jogo.

​
Sintaxe

​
Parâmetros

exePath   _In_z_
Tipo: char* O caminho e o nome do arquivo do novo jogo a ser iniciado. Esse caminho pode ser relativo ao diretório atual ou um caminho absoluto. Os jogos que precisam saber o caminho do executável chamador podem chamar GetModuleFileNameA com nullptr para o identificador do módulo. args   _In_opt_z_
Tipo: char* Quaisquer argumentos aplicáveis e específicos do jogo com os quais iniciar o novo jogo. defaultUser   _In_opt_
Tipo: XUserHandle O identificador do usuário que está iniciando o novo jogo. Se um valor não for especificado, o usuário atual será especificado.

​
Valor retornado

Tipo: void Esta função não retorna um valor nem gera exceções, mesmo que não consiga reiniciar o jogo.

​
Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais
informações, consulte Threads sensíveis ao tempo. Esta função reinicia o jogo, encerra o processo atual do jogo e reinicia o jogo usando um novo processo. O jogo é reiniciado sem reiniciar a máquina virtual na qual o jogo está sendo executado. Você tem a opção de especificar um usuário padrão diferente e argumentos específicos do jogo com os quais o jogo será reiniciado; para obter detalhes sobre como especificar um usuário padrão diferente, consulte Identidade do usuário e XUser. O processo atual é sempre encerrado, mesmo que a função encontre um erro ao iniciar um novo jogo. Por exemplo, se qualquer valor especificado para exePath, args ou defaultUser não for válido, a função não retorna um valor nem gera uma exceção.
Quando esta função é chamada, todo o DLC montado anteriormente será
desmontado, com exceção do DLC que hospeda o destino de XLaunchNewGame. A unidade G: continuará apontando para a raiz do pacote base e não para o EXE recém-iniciado.
Se um jogo for suspenso depois que XLaunchNewGame for chamado, mas antes de
o jogo recém-iniciado configurar seu manipulador de suspensão, o jogo será encerrado. Essa é uma janela de tempo muito estreita e, na prática, deve ser uma ocorrência muito improvável.
A memória transferida ao sistema usando XMemTransferMemory (tópico sob NDA) é mantida.

​
Requisitos

Cabeçalho: XGame.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

​
Documentação conceitual

​
Confira também

XGame
Identidade do usuário e XUser
XLaunchUri
Last modified on October 6, 2026