Skip to main content

WdLaunchRemoteGame

Inicia un juego en un dispositivo remoto.

Sintaxis

Parámetros

_In_z_ remoteDevice
Tipo: const char*
Nombre de host o dirección IP del dispositivo remoto (por ejemplo, "192.168.1.100" o "MyDevKit"). _In_z_ remotePath
Tipo: const char*
Ruta de acceso al ejecutable del juego en el dispositivo remoto. Puede ser una ruta de acceso absoluta (por ejemplo, "D:\\Games\\MyGame\\game.exe") o una ruta de acceso relativa que se resuelve con respecto a la raíz común (por ejemplo, "MyGame\\game.exe"). _In_opt_z_ args
Tipo: const char*
Opcional. Argumentos de línea de comandos que se pasarán al ejecutable del juego (por ejemplo, "-windowed -debug"). Pase nullptr si no se necesitan argumentos. _In_opt_ launchOptions
Tipo: WdLaunchOptions*
Opcional. Especifica el modo de inicio y el alias de la raíz común. Pase nullptr para usar la configuración predeterminada (inicio Immediate, raíz común predeterminada). _Out_opt_ processId
Tipo: uint32_t*
Opcional. Recibe el identificador de proceso del juego iniciado. Pase nullptr si no se necesita el identificador de proceso. _Out_opt_ threadId
Tipo: uint32_t*
Opcional. Recibe el identificador de subproceso del subproceso principal del juego iniciado. Pase nullptr si no se necesita el identificador de subproceso.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error.

Códigos de error

Comentarios

Solo puede haber un proceso de juego en ejecución en el dispositivo remoto a la vez. Si ya hay un juego en ejecución, esta función lo finalizará automáticamente y lo iniciará de nuevo. El juego existente se puede finalizar mediante WdTerminateRemoteGame antes de iniciar uno nuevo. Cuando se inicia con WdLaunchMode::Suspended, el proceso del juego se inicia en estado suspendido. Use WdResumeRemoteGame para reanudar la ejecución. Esto resulta útil para asociar un depurador antes de que el juego comience a ejecutarse.

Ejemplos

Ejemplo 1: Iniciar un juego en un dispositivo remoto

Inicia un ejecutable de juego copiado previamente usando la configuración predeterminada (ejecución inmediata, raíz común predeterminada).

Ejemplo 2: Iniciar en modo suspendido para depurar

Inicia el juego en estado suspendido para poder asociar un depurador antes de que comience la ejecución. Una vez conectado el depurador, el usuario presiona Entrar para reanudar el proceso.

Ejemplo 3: Flujo de trabajo de copia e inicio

Muestra el ciclo de iteración típico: copiar los archivos del juego al dispositivo remoto y, a continuación, iniciar el ejecutable. Este es el flujo de trabajo integral más común de la API XBOX PC Remote Iteration.

Requisitos

Consulte también

Última modificación el 28 de agosto de 2026