Skip to main content

XGameRuntimeInitialize

Gaming Runtime を初期化します。

Syntax

Parameters

なし。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。エラー コードの一覧については、エラー コードを参照してください。Gaming Runtime ライブラリ (xgameruntime.dll) が見つからなかったために関数が失敗した場合、戻り値は E_GAMERUNTIME_DLL_NOT_FOUND に設定されます。

Remarks

ゲームで Gaming Runtime 機能を使用するには、まず XGameRuntimeInitialize 関数を呼び出して Gaming Runtime を初期化します。XGameRuntimeInitialize 関数は、通常はゲームのエントリ ポイント関数内で、できるだけ早い段階で呼び出します。同様に、Gaming Runtime の初期化解除は、ゲームが終了する前のできるだけ遅い段階で、XGameRuntimeUninitialize 関数を呼び出して行います。 ゲーム ランタイムに対してコンパイルおよびリンクする各バイナリは、起動の早い段階で XGameRuntimeInitialize を呼び出す必要があります。これには、ゲーム バイナリと、Gaming Runtime 機能を使用する DLL 形式のミドルウェアが含まれます。XGameRuntimeInitialize 関数の内部では、タイトルがコンパイル時に使用したすべてのインターフェイスのバージョンがチェックされ、対応するランタイム サービスの初期化に使用されます。Gaming Runtime の 2 つの異なるバージョン間では、関数が追加、削除、またはまれに互換性のない動作変更が行われる場合があります。各コンポーネントから XGameRuntimeInitialize を呼び出すことにより、同じプロセス内で読み込まれる 2 つの異なるバイナリが、互換性のない異なるバージョンのゲーム ランタイムに対してコンパイルされているようなビルド構成の問題を検出しやすくなります。このような互換性のない構成は、E_GAMERUNTIME_VERSION_MISMATCH エラーになります。 次の例は、Visual Studio の Direct3D 12 Desktop Game テンプレートに基づくゲームのエントリ ポイント関数で XGameRuntimeInitialize および XGameRuntimeUninitialize 関数を使用する方法を示します。XGameRuntimeInitialize 関数は Game オブジェクトのインスタンス化と登録の前に呼び出され、XGameRuntimeUninitialize 関数は Game オブジェクトがリセットされた後、エントリ ポイント関数が返される前に呼び出されます。

Requirements

ヘッダー: XGameRuntimeInit.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XGameRuntimeUninitialize
XGameRuntimeInitializeWithOptions
XGameRuntimeInit
XGameRuntime Structures
XGameRuntime Enumerations
Developing new titles using Gaming Runtime
最終更新日 2026年8月24日