Skip to main content

XPackageInstallChunks

チャンクのインストールを開始します。

Syntax

Parameters

packageIdentifier   _In_z_
型: char*
ディスク上のインストール済みパッケージを一意に識別する文字列。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 selectorCount   _In_
型: uint32_t
selectors パラメーター内のセレクターの数。 selectors   _In_reads_(selectorCount)
型: XPackageChunkSelector*
インストールするチャンクを指定するセレクターの配列。 minimumUpdateIntervalMs   _In_
型: uint32_t
更新の間隔 (ミリ秒単位)。 suppressUserConfirmation   _In_
型: bool
インストールするチャンクが事前設定されたサイズを超える場合、確認プロンプトが表示されます。suppressUserConfirmation が true の場合、プロンプトは表示されず、ユーザーが承諾したかのようにインストールが進行します。これにより、ゲームは独自の UI を表示できます。ゲームがこれを使用する場合、XPackageEstimateDownloadSize を呼び出して、ユーザーに表示されるサイズも取得する必要があります。XPackageEstimateDownloadSize はまた、サイズがプロンプトを表示するのに十分な大きさかどうかを示すブール値を返します。ダウンロード確認が必要な場合、ゲームは独自の UI を使用して表示するか、XPackageInstallChunks に表示させる必要があります。 queue   _In_opt_
型: XTaskQueueHandle
作業が実行される非同期キュー。 installationMonitor   _Out_
型: XPackageInstallationMonitorHandle*
戻り時、セレクターに一致するチャンクのインストールを監視するインストール モニターへのハンドルを含みます。

Return value

型: HRESULT HRESULT の成功またはエラー コード。
インストールが拒否された場合はキャンセル エラーを返します。

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
チャンクのインストールでは、ダウンロード サイズを承諾するようユーザーに促す場合があります。
  • この API の同期バージョンを使用すると、ユーザーがダウンロードを承諾または拒否するまでブロックします。ユーザーが拒否した場合、呼び出しはキャンセル エラー E_ABORT で失敗します。これはインストール状態を監視するために使用できるインストール モニターを返します。モニターは最終的に XPackageCloseInstallationMonitorHandle を呼び出して閉じる必要があります。
  • suppressUserConfirmation を true に設定すると、ユーザーにダウンロードを促すカスタム UI を提供できます。
この例では、“BigMaps” タグに対応するチャンクをインストールします:

Requirements

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

Conceptual documentation

See also

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