XGameRuntimeInitialize
初始化 Gaming Runtime。語法
參數
無。傳回值
類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。如需錯誤碼清單,請參閱錯誤碼。如果函式因找不到 Gaming Runtime 程式庫 (xgameruntime.dll) 而失敗,傳回值會設為 E_GAMERUNTIME_DLL_NOT_FOUND。備註
若要在遊戲中使用 Gaming Runtime 功能,請先叫用 XGameRuntimeInitialize 函式來初始化 Gaming Runtime。請盡早叫用 XGameRuntimeInitialize 函式,通常是在遊戲的進入點函式中。同樣地,請盡可能延後 (但在遊戲結束之前) 叫用 XGameRuntimeUninitialize 函式來取消初始化 Gaming Runtime。 每個針對遊戲執行階段進行編譯和連結的二進位檔,都應該在啟動初期呼叫 XGameRuntimeInitialize。這包括遊戲二進位檔,以及任何使用 Gaming Runtime 功能的 DLL 形式中介軟體。在 XGameRuntimeInitialize 函式內部,會檢查遊戲編譯時所針對的所有介面版本,並用來初始化相符的執行階段服務。在兩個不同版本的 Gaming Runtime 之間,函式可能會新增、移除,或在少數情況下出現中斷性的行為變更。從每個元件呼叫 XGameRuntimeInitialize 有助於偵測組建設定問題,例如將在同一個處理序中載入的兩個不同二進位檔,分別針對兩個不同且不相容的遊戲執行階段版本進行編譯。此類中斷性設定會導致 E_GAMERUNTIME_VERSION_MISMATCH 錯誤。 下列範例示範如何在以 Visual Studio 中 Direct3D 12 Desktop Game 範本為基礎之遊戲的進入點函式內,使用 XGameRuntimeInitialize 和 XGameRuntimeUninitialize 函式。XGameRuntimeInitialize 函式會在 Game 物件具現化並註冊之前叫用,而 XGameRuntimeUninitialize 函式會在 Game 物件重設之後、進入點函式傳回之前叫用。需求
標頭: XGameRuntimeInit.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XGameRuntimeUninitializeXGameRuntimeInitializeWithOptions
XGameRuntimeInit
XGameRuntime 結構
XGameRuntime 列舉
使用 Gaming Runtime 開發新遊戲
