Skip to main content

WdLaunchRemoteGame

Lance un jeu sur un appareil distant.

Syntaxe

Paramètres

_In_z_ remoteDevice
Type : const char*
Le nom d’hôte ou l’adresse IP de l’appareil distant (p. ex., "192.168.1.100" ou "MyDevKit"). _In_z_ remotePath
Type : const char*
Le chemin de l’exécutable du jeu sur l’appareil distant. Il peut s’agir d’un chemin absolu (p. ex., "D:\\Games\\MyGame\\game.exe") ou d’un chemin relatif résolu par rapport à la racine commune (p. ex., "MyGame\\game.exe"). _In_opt_z_ args
Type : const char*
Facultatif. Arguments de ligne de commande à transmettre à l’exécutable du jeu (p. ex., "-windowed -debug"). Passez nullptr si aucun argument n’est requis. _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 requis. _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 requis.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne 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 y met fin automatiquement et le relance. Il est possible de mettre fin au jeu existant au moyen de WdTerminateRemoteGame avant d’en lancer un nouveau. Lorsqu’il est lancé avec WdLaunchMode::Suspended, le processus du jeu démarre dans un é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 copié précédemment en utilisant les 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 dans un é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