Skip to main content

XPackageCloseInstallationMonitorHandle

以前に開かれた、指定されたインストール モニターを閉じます。

Syntax

Parameters

installationMonitor   _In_
型: XPackageInstallationMonitorHandle
閉じるインストール モニターへのハンドル。

Return value

型: void

Remarks

インストールの状態を監視するために使用したインストール モニターは、最終的に XPackageCloseInstallationMonitorHandle を呼び出して閉じる必要があります。 ゲームが起動マーカーを実装しているため、完全にインストールされる前に実行できます。ゲームは、どの部分がインストールされていて、どの部分がインストールされていないかを知る必要があります。この例では、指定されたトラック名を持つレーストラックに関連付けられたチャンクがいつインストールされるかを知る必要があります:
上記のコードの各 API 呼び出しを順に見ていきましょう:
インストールされたすべてのコンテンツには一意の識別子があります。パッケージ識別子を知っており、そのコンテンツにアクセス権があれば、任意のパッケージ インストールを監視できます。実行中のプロセスは自身のパッケージ識別子を取得できます。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。
これにより、インストールの状態を追跡するモニターが作成されます。このインストール モニターは、定期的なペースで自身を更新します。インストールの現在の進行状況を取得するには、XPackageGetInstallationProgress を呼び出します。インストール中の変更の通知を受けるには、コールバックを登録します。 パッケージ全体または特定のサブセットに対してインストール モニターを作成できます。ここでは、トラック名のインストール進行状況を知りたいと指定する「セレクター」を定義しています。インストール モニターが進捗状況のスナップショットを更新する頻度を指定できます (この場合は 1000 ms)。この速度が上限です。時間内に進行がなかった場合は、より遅くなる可能性があります。
トラックがいつロードを完了したかを知りたいので、モニターに進捗変更イベントを登録します。このコールバックは、モニターが作成されたときに提供されたタスク キューを通じて、XPackageCreateInstallationMonitor で指定されたおおよそのペースで呼び出されます。コールバック内で、ゲーム内の進捗を描画したり、トラックの準備が整ったことをゲームに通知したりできます。 この例では、インストール モニターを閉じますが、通知の登録は解除しません。インストール モニター通知のライフタイムはインストール モニターに結び付けられているため、モニターを閉じることで、それに関連するすべての通知が登録解除されます。

Requirements

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

See also

XPackage
最終更新日 2026年8月24日