> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XLaunchNewGame

> XLaunchNewGame

# XLaunchNewGame

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

## 語法

```cpp theme={null}
void XLaunchNewGame(  
         const char* exePath,  
         const char* args,  
         XUserHandle defaultUser  
)  
```

### 參數

*exePath*   \_In\_z\_\
類型：char\*

要啟動之新遊戲的路徑和檔案名稱。此路徑可以是相對於目前目錄的路徑，也可以是絕對路徑。需要知道呼叫端可執行檔路徑的遊戲，可以使用 nullptr 作為模組控制代碼來呼叫 [GetModuleFileNameA](https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulefilenamea)。

*args*   \_In\_opt\_z\_\
類型：char\*

用來啟動新遊戲的任何適用遊戲特定引數。

*defaultUser*   \_In\_opt\_\
類型：XUserHandle

啟動新遊戲之使用者的控制代碼。如果未指定值，則會指定
目前的使用者。

### 傳回值

類型：void

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

## 備註

<Note>在時間敏感的執行緒上呼叫此函式並不安全。如需</Note>
詳細資訊，請參閱[時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。

此函式會重新啟動遊戲：結束遊戲目前的處理程序，並使用
新的處理程序重新啟動遊戲。遊戲會在不重新啟動其所執行之虛擬機器的情況下
重新啟動。您可以選擇指定不同的預設使用者和遊戲特定引數
來重新啟動遊戲；如需指定不同預設使用者的詳細資料，請參閱[使用者
身分識別與 XUser](/zh-TW/build/core-features/common/user/player-identity-xuser)。

即使函式在啟動新遊戲時發生錯誤，目前的處理程序也一律會被終止。
例如，如果為 *exePath*、*args* 或 *defaultUser* 指定的任何值無效，
函式也不會傳回值或引發例外狀況。

<Note>呼叫此函式時，所有先前掛接的 DLC 都會被</Note>
卸載，但裝載 **XLaunchNewGame** 目標的 DLC 除外。**G:**
磁碟機會繼續指向基礎套件的根目錄，而不是新啟動的 EXE。

<Note>如果遊戲在呼叫 **XLaunchNewGame** 之後、但在</Note>
新啟動的遊戲設定其暫停處理常式之前被暫停，遊戲將會被終止。這是
非常短暫的時間範圍，實際上應該極不可能發生。

<Note>使用 [XMemTransferMemory (NDA 主題)](/zh-TW/reference/system/xmem/functions/xmemtransfermemory) 傳輸給系統的記憶體會保留下來。</Note>

## 需求

**標頭：** XGame.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [時間敏感的執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [支援遊戲即服務 (GaaS)](/zh-TW/build/core-features/common/packaging/supporting-games-as-a-service)

## 另請參閱

[XGame](/zh-TW/reference/system/xgame/xgame_members)\
[使用者身分識別與 XUser](/zh-TW/build/core-features/common/user/player-identity-xuser)\
[XLaunchUri](/zh-TW/reference/system/xlauncher/functions/xlaunchuri)


## Related topics

- [XLaunchNewGame](/reference/system/xgame/functions/xlaunchnewgame.md)
- [XLaunchRestartOnCrash](/reference/system/xgame/functions/xlaunchrestartoncrash.md)
- [XGame](/reference/system/xgame/xgame_members.md)