Skip to main content

WdLaunchRemoteGame

Lance un jeu sur un appareil distant.

Syntaxe

Paramètres

_In_z_ remoteDevice
Type : const char*
Nom d’hôte ou adresse IP de l’appareil distant (par exemple, "192.168.1.100" ou "MyDevKit"). _In_z_ remotePath
Type : const char*
Chemin d’accès à l’exécutable du jeu sur l’appareil distant. Il peut s’agir d’un chemin absolu (par exemple, "D:\\Games\\MyGame\\game.exe") ou d’un chemin relatif résolu par rapport à la racine commune (par exemple, "MyGame\\game.exe"). _In_opt_z_ args
Type : const char*
Facultatif. Arguments de ligne de commande à transmettre à l’exécutable du jeu (par exemple, "-windowed -debug"). Passez nullptr si aucun argument n’est nécessaire. _In_opt_ launchOptions
Type : WdLaunchOptions*
Facultatif. Spécifie le mode de lancement et l’alias de racine commune. Passez nullptr pour utiliser les paramètres par défaut (lancement Immediate, racine commune par défaut). _Out_opt_ processId
Type : uint32_t*
Facultatif. Reçoit l’ID de processus du jeu lancé. Passez nullptr si l’ID de processus n’est pas nécessaire. _Out_opt_ threadId
Type : uint32_t*
Facultatif. Reçoit l’ID du thread principal du jeu lancé. Passez nullptr si l’ID de thread n’est pas nécessaire.

Valeur de retour

Type : HRESULT Renvoie S_OK en cas de réussite ; sinon, renvoie un code d’erreur.

Codes d’erreur

Remarques

Un seul processus de jeu peut s’exécuter à la fois sur l’appareil distant. Si un jeu est déjà en cours d’exécution, cette fonction l’arrête automatiquement et le relance. Le jeu existant peut être arrêté à l’aide de WdTerminateRemoteGame avant d’en lancer un nouveau. Lorsqu’il est lancé avec WdLaunchMode::Suspended, le processus du jeu démarre à l’état suspendu. Utilisez WdResumeRemoteGame pour reprendre l’exécution. Cela est utile pour attacher un débogueur avant que le jeu ne commence à s’exécuter.

Exemples

Exemple 1 : Lancer un jeu sur un appareil distant

Lance un exécutable de jeu précédemment copié à l’aide des paramètres par défaut (exécution immédiate, racine commune par défaut).

Exemple 2 : Lancer en mode suspendu pour le débogage

Lance le jeu à l’état suspendu afin qu’un débogueur puisse être attaché avant le début de l’exécution. Une fois le débogueur connecté, l’utilisateur appuie sur Entrée pour reprendre le processus.

Exemple 3 : Flux de travail de copie et de lancement

Illustre le cycle d’itération typique : copier les fichiers du jeu sur l’appareil distant, puis lancer l’exécutable. Il s’agit du flux de travail de bout en bout le plus courant pour l’API XBOX PC Remote Iteration.

Configuration requise

Voir aussi

Last modified on October 6, 2026