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*
選用。接收所啟動遊戲的處理程序識別碼。如果不需要處理程序識別碼,請傳遞 nullptr。 _Out_opt_ threadId
類型:uint32_t*
選用。接收所啟動遊戲主執行緒的執行緒識別碼。如果不需要執行緒識別碼,請傳遞 nullptr。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。

錯誤碼

備註

遠端裝置上一次只能執行一個遊戲處理程序。如果已有遊戲正在執行,此函式會自動終止該遊戲並重新啟動。您可以在啟動新遊戲之前,使用 WdTerminateRemoteGame 終止現有的遊戲。 以 WdLaunchMode::Suspended 啟動時,遊戲處理程序會以暫停狀態啟動。請使用 WdResumeRemoteGame 繼續執行。這適用於在遊戲開始執行之前附加偵錯工具。

範例

範例 1:在遠端裝置上啟動遊戲

使用預設設定 (立即執行、預設通用根目錄) 啟動先前複製的遊戲可執行檔。

範例 2:以暫停模式啟動以進行偵錯

以暫停狀態啟動遊戲,以便在開始執行之前附加偵錯工具。偵錯工具連線之後,使用者按下 Enter 鍵即可繼續處理程序。

範例 3:複製並啟動的工作流程

示範典型的反覆運算週期:將遊戲檔案複製到遠端裝置,然後啟動可執行檔。這是 XBOX PC Remote Iteration API 最常見的端對端工作流程。

需求

另請參閱

Last modified on October 6, 2026