Skip to main content

WdLaunchRemoteGame

Inicia um jogo em um dispositivo remoto.

Sintaxe

Parâmetros

_In_z_ remoteDevice
Tipo: const char*
O nome do host ou o endereço IP do dispositivo remoto (por exemplo, "192.168.1.100" ou "MyDevKit"). _In_z_ remotePath
Tipo: const char*
O caminho para o executável do jogo no dispositivo remoto. Pode ser um caminho absoluto (por exemplo, "D:\\Games\\MyGame\\game.exe") ou um caminho relativo resolvido em relação à raiz comum (por exemplo, "MyGame\\game.exe"). _In_opt_z_ args
Tipo: const char*
Opcional. Argumentos de linha de comando a serem passados para o executável do jogo (por exemplo, "-windowed -debug"). Passe nullptr se nenhum argumento for necessário. _In_opt_ launchOptions
Tipo: WdLaunchOptions*
Opcional. Especifica o modo de inicialização e o alias da raiz comum. Passe nullptr para usar as configurações padrão (inicialização Immediate, raiz comum padrão). _Out_opt_ processId
Tipo: uint32_t*
Opcional. Recebe a ID do processo do jogo iniciado. Passe nullptr se a ID do processo não for necessária. _Out_opt_ threadId
Tipo: uint32_t*
Opcional. Recebe a ID do thread principal do jogo iniciado. Passe nullptr se a ID do thread não for necessária.

Valor retornado

Tipo: HRESULT Retorna S_OK se for bem-sucedido; caso contrário, retorna um código de erro.

Códigos de erro

Comentários

Somente um processo de jogo pode estar em execução no dispositivo remoto por vez. Se um jogo já estiver em execução, essa função o encerrará automaticamente e o iniciará novamente. O jogo existente pode ser encerrado usando WdTerminateRemoteGame antes de iniciar um novo. Quando iniciado com WdLaunchMode::Suspended, o processo do jogo começa em estado suspenso. Use WdResumeRemoteGame para retomar a execução. Isso é útil para anexar um depurador antes que o jogo comece a ser executado.

Exemplos

Exemplo 1: Iniciar um jogo em um dispositivo remoto

Inicia um executável de jogo copiado anteriormente usando as configurações padrão (execução imediata, raiz comum padrão).

Exemplo 2: Iniciar no modo suspenso para depuração

Inicia o jogo em estado suspenso para que um depurador possa ser anexado antes do início da execução. Depois que o depurador estiver conectado, o usuário pressiona Enter para retomar o processo.

Exemplo 3: Fluxo de trabalho de cópia e inicialização

Demonstra o ciclo de iteração típico: copiar os arquivos do jogo para o dispositivo remoto e, em seguida, iniciar o executável. Esse é o fluxo de trabalho de ponta a ponta mais comum da XBOX PC Remote Iteration API.

Requisitos

Confira também

Last modified on October 6, 2026