次の方法で共有

XtfStartTitleOSByVersion

  • [アーティクル]

指定された FourPartVersion と一致するゲーム OS を本体のキャッシュから起動または再起動します。

構文

HRESULT XtfStartTitleOSByVersion(
         PCWSTR address,
         FourPartVersion version
)

パラメーター

address
型: PCWSTR

[in] 本体のアドレス。

バージョン
型: FourPartVersion

[in] 起動するゲーム OS の 4 つの部分から成るバージョン情報。

戻り値

型: HRESULT

正常に実行された場合は S_OK を返し、失敗した場合は HRESULT エラー コードを返します。

解説

この関数を使用して、指定した FourPartVersion と一致するゲーム OS を本体のキャッシュから起動または再起動します。 XtfGetCachedTitleOSVersions 関数を使用して、本体にキャッシュされている各ゲーム OS の FourPartVersion を取得できます。または、XtfGetTitleOSFourPartVersion 関数を使用して、現在実行中のタイトルのゲーム OS の FourPartVersion を取得できます。

起動または再起動するゲーム OS の FourPartVersion がない場合は、代わりに、XtfStartTitleOS 関数を使用して、たとえばゲーム OS の GameOs.vxd ファイルの完全なパスとファイル名などの別の識別子を指定してゲーム OS を起動または再起動します。 また、XtfStartTitleOSByGameConfig 関数を使用して、MicrosoftGame.config ファイルの指定されたコンテンツで特定されたゲーム OS を起動または再起動することもできます。

必要に応じて、XtfCacheTitleOS 関数を呼び出すことによって、本体のキャッシュにゲーム OS を追加できます。 プロビジョニングされたゲーム OS ファイルの管理の詳細については、「アプリケーション管理 (xbapp.exe) (NDA トピック)」および「プロビジョニング (xbprovision.exe) (NDA トピック)」を参照してください。

要件

ヘッダー: xtfapi.h

ライブラリ: XtfApi.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

PC 展開から実行する (NDA トピック)
XTF トランスポート エラー (NDA トピック)
その他の Xtf API