Skip to main content

XtfStartTitleOS

指定した Game OS を起動または再起動します。

構文

パラメーター

address
型: PCWSTR
[in] 本体のアドレスです。 osIdentifier
型: PCWSTR
[in, optional] 起動する Game OS の識別子です。 この識別子には、次のいずれかを指定できます。
  • 起動する Game OS バージョンの 4 パートのバージョン番号を含む MicrosoftGame.config ファイルの完全パスとファイル名
  • GameOs.xvd ファイルの完全パスとファイル名
  • MicrosoftGame.config または GameOS.vxd ファイルを含むディレクトリの完全パス
  • 起動する Game OS の 4 パートのバージョン番号
有効な識別子の例:
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

戻り値

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

解説

この関数を使用して、本体のキャッシュから指定した Game OS を起動または再起動します。 起動する Game OS の FourPartVersion がある場合は、代わりに XtfStartTitleOSByVersion 関数を使用してその Game OS バージョンを起動してください。 本体にキャッシュされている各 Game OS の FourPartVersion を取得するには XtfGetCachedTitleOSVersions 関数を、現在実行中のタイトルの Game OS の FourPartVersion を取得するには XtfGetTitleOSFourPartVersion 関数を使用できます。 指定した MicrosoftGame.config ファイルの内容で識別される Game OS を起動するには、XtfStartTitleOSByGameConfig 関数を使用することもできます。 必要な場合は、XtfCacheTitleOS 関数を呼び出して、本体のキャッシュに Game OS を追加できます。 プロビジョニング済み Game OS ファイルの管理の詳細については、アプリケーション管理 (xbapp.exe) (NDA トピック) および プロビジョン (xbprovision.exe) (NDA トピック) を参照してください。

要件

ヘッダー: xtfapi.h ライブラリ: XtfApi.lib サポートされているプラットフォーム: Windows (XBOX 本体ツール用)

関連項目

PC からのデプロイ実行 (NDA トピック)
XTF トランスポート エラー (NDA トピック)
その他の Xtf API
最終更新日 2026年8月24日