Skip to main content

​
XLaunchNewGame

結束目前的遊戲、釋放所有已配置的資源，並啟動新遊戲。

​
語法

​
參數

exePath   _In_z_
類型：char* 要啟動之新遊戲的路徑和檔案名稱。此路徑可以是相對於目前目錄的路徑，也可以是絕對路徑。需要知道呼叫端可執行檔路徑的遊戲，可以使用 nullptr 作為模組控制代碼來呼叫 GetModuleFileNameA。 args   _In_opt_z_
類型：char* 用來啟動新遊戲的任何適用遊戲特定引數。 defaultUser   _In_opt_
類型：XUserHandle 啟動新遊戲之使用者的控制代碼。如果未指定值，則會指定 目前的使用者。

​
傳回值

類型：void 即使無法重新啟動遊戲，此函式也不會傳回值或引發例外狀況。

​
備註

在時間敏感的執行緒上呼叫此函式並不安全。如需
詳細資訊，請參閱時間敏感的執行緒。 此函式會重新啟動遊戲：結束遊戲目前的處理程序，並使用 新的處理程序重新啟動遊戲。遊戲會在不重新啟動其所執行之虛擬機器的情況下 重新啟動。您可以選擇指定不同的預設使用者和遊戲特定引數 來重新啟動遊戲；如需指定不同預設使用者的詳細資料，請參閱使用者 身分識別與 XUser。 即使函式在啟動新遊戲時發生錯誤，目前的處理程序也一律會被終止。 例如，如果為 exePath、args 或 defaultUser 指定的任何值無效， 函式也不會傳回值或引發例外狀況。
呼叫此函式時，所有先前掛接的 DLC 都會被
卸載，但裝載 XLaunchNewGame 目標的 DLC 除外。G: 磁碟機會繼續指向基礎套件的根目錄，而不是新啟動的 EXE。
如果遊戲在呼叫 XLaunchNewGame 之後、但在
新啟動的遊戲設定其暫停處理常式之前被暫停，遊戲將會被終止。這是 非常短暫的時間範圍，實際上應該極不可能發生。
使用 XMemTransferMemory (NDA 主題) 傳輸給系統的記憶體會保留下來。

​
需求

標頭： XGame.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
概念文件

​
另請參閱

XGame
使用者身分識別與 XUser
XLaunchUri
Last modified on October 6, 2026