Skip to main content

WdLaunchRemoteGame

在远程设备上启动游戏。

语法

参数

_In_z_ remoteDevice
类型:const char*
远程设备的主机名或 IP 地址(例如 "192.168.1.100""MyDevKit")。 _In_z_ remotePath
类型:const char*
远程设备上游戏可执行文件的路径。可以是绝对路径(例如 "D:\\Games\\MyGame\\game.exe"),或相对于公共根解析的相对路径(例如 "MyGame\\game.exe")。 _In_opt_z_ args
类型:const char*
可选。要传递给游戏可执行文件的命令行参数(例如 "-windowed -debug")。如果不需要参数,则传入 nullptr _In_opt_ launchOptions
类型:WdLaunchOptions*
可选。指定启动模式和公共根别名。传入 nullptr 以使用默认设置(Immediate 启动、默认公共根)。 _Out_opt_ processId
类型:uint32_t*
可选。接收已启动游戏的进程 ID。如果不需要进程 ID,则传入 nullptr _Out_opt_ threadId
类型:uint32_t*
可选。接收已启动游戏主线程的线程 ID。如果不需要线程 ID,则传入 nullptr

返回值

类型:HRESULT 如果成功,则返回 S_OK;否则,返回错误代码。

错误代码

备注

同一时间在远程设备上只能有一个游戏进程运行。如果游戏已在运行,此函数将自动终止它并重新启动。可以在启动新游戏之前使用 WdTerminateRemoteGame 终止现有游戏。 当使用 WdLaunchMode::Suspended 启动时,游戏进程会以挂起状态启动。使用 WdResumeRemoteGame 恢复执行。这在游戏开始执行之前附加调试器时非常有用。

示例

示例 1:在远程设备上启动游戏

使用默认设置(立即执行、默认公共根)启动先前已复制的游戏可执行文件。

示例 2:以挂起模式启动以进行调试

以挂起状态启动游戏,以便在开始执行之前附加调试器。附加调试器后,用户按 Enter 恢复进程。

示例 3:复制并启动工作流

演示典型的迭代循环:将游戏文件复制到远程设备,然后启动可执行文件。这是 XBOX PC 远程迭代 API 最常见的端到端工作流。

要求

另请参阅

最后修改于 2026年8月24日