XGameRuntimeUninitialize

ゲーム ランタイムの初期化を解除します。

構文

void XGameRuntimeUninitialize(  
)  

パラメーター

ありません。

戻り値

型: void

解説

ゲームでゲーム ランタイム機能を使用するには、まず XGameRuntimeInitialize 関数を発生させてゲーム ランタイムを初期化します。 ゲーム ランタイムを使用してゲームが完了し、終了する準備ができた場合は、 XGameRuntimeUninitialize 関数を発生させてゲーム ランタイムの初期化を解除します。 一般的にはゲームのエントリポイント関数で、XGameRuntimeUninitialize 関数をなるべく遅く (ただし、ゲームが終了する前に) 発生させます。

次の例では、Visual Studio 内で Direct3D 12 Desktop Game テンプレートに基づき、ゲームのエントリポイント関数で XGameRuntimeInitialize 関数と XGameRuntimeUninitialize 関数を使用する方法について示します。 XGameRuntimeInitialize 関数は、Game オブジェクトがインスタンス作成されて登録される前に発生し、XGameRuntimeUninitialize 関数は、Game オブジェクトがリセットされた後、エントリポイント関数が返される前に発生します。

// Entry point
int WINAPI wWinMain(_In_ HINSTANCE hInstance, _In_opt_ HINSTANCE hPrevInstance, _In_ LPWSTR lpCmdLine, _In_ int nCmdShow)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    // Initialize the Gaming Runtime before
    // performing any other activity.
    if (FAILED(XGameRuntimeInitialize()))
        return 1;

    if (!XMVerifyCPUSupport())
        return 1;

    g_game = std::make_unique<Game>();

    // Register class and create window
    {
        // Code omitted for brevity.
        ...
    }

    // Main message loop
    MSG msg = {};
    while (WM_QUIT != msg.message)
    {
        // Code omitted for brevity.
        ...
    }

    g_game.reset();

    // Uninitialize the Gaming Runtime after
    // all other activity has been completed.
    XGameRuntimeUninitialize();

    return (int) msg.wParam;
}

要件

ヘッダー: XGameRuntimeInit.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XGameRuntimeInitializeXGameRuntimeInitゲーム ランタイムを使用した新しいタイトルの開発