Skip to main content

WdLaunchRemoteGame

リモート デバイス上でゲームを起動します。

構文

パラメーター

_In_z_ remoteDevice
Type: const char*
リモート デバイスのホスト名または IP アドレス (例: "192.168.1.100" または "MyDevKit")。 _In_z_ remotePath
Type: const char*
リモート デバイス上のゲーム実行可能ファイルへのパス。絶対パス (例: "D:\\Games\\MyGame\\game.exe")、または共通ルートに対して解決される相対パス (例: "MyGame\\game.exe") を指定できます。 _In_opt_z_ args
Type: const char*
省略可能。ゲーム実行可能ファイルに渡すコマンド ライン引数 (例: "-windowed -debug")。引数が不要な場合は nullptr を渡します。 _In_opt_ launchOptions
Type: WdLaunchOptions*
省略可能。起動モードと共通ルート エイリアスを指定します。既定の設定 (Immediate 起動、既定の共通ルート) を使用するには nullptr を渡します。 _Out_opt_ processId
Type: uint32_t*
省略可能。起動されたゲームのプロセス ID を受け取ります。プロセス ID が不要な場合は nullptr を渡します。 _Out_opt_ threadId
Type: uint32_t*
省略可能。起動されたゲームのメイン スレッドのスレッド ID を受け取ります。スレッド ID が不要な場合は nullptr を渡します。

戻り値

Type: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

エラー コード

解説

リモート デバイス上で同時に実行できるゲーム プロセスは 1 つだけです。ゲームが既に実行中の場合、この関数は自動的にそれを終了させて再度起動します。新しいゲームを起動する前に、WdTerminateRemoteGame を使用して既存のゲームを終了することもできます。 WdLaunchMode::Suspended で起動した場合、ゲーム プロセスは中断状態で開始します。実行を再開するには WdResumeRemoteGame を使用します。これは、ゲームが実行を開始する前にデバッガーをアタッチする場合に便利です。

例 1: リモート デバイス上でゲームを起動する

既定の設定 (即時実行、既定の共通ルート) を使用して、以前にコピーされたゲーム実行可能ファイルを起動します。

例 2: デバッグのために中断モードで起動する

実行が開始する前にデバッガーをアタッチできるように、ゲームを中断状態で起動します。デバッガーが接続された後、ユーザーが Enter キーを押してプロセスを再開します。

例 3: コピーと起動のワークフロー

一般的なイテレーション サイクルを示します。ゲーム ファイルをリモート デバイスにコピーし、次に実行可能ファイルを起動します。これは、XBOX PC Remote Iteration API で最も一般的なエンドツーエンドのワークフローです。

要件

関連項目

最終更新日 2026年8月24日