Skip to main content

XPackageInstallChunksAsync

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

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 に表示させる必要があります。 asyncBlock   _Inout_
型: XAsyncBlock*
非同期呼び出しの状態を監視するための XAsyncBlock

Return value

型: HRESULT HRESULT の成功またはエラー コード。

Remarks

XPackageInstallChunks には非同期バリアントがあります。チャンクのインストールでは、ダウンロード サイズを承諾するようユーザーに促す場合があります。 この例では、非同期 API を使用して BigMaps をインストールする方法を示します:

Requirements

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

Conceptual documentation

See also

XPackage
ストリーミング インストールとインテリジェント デリバリー
XPackageInstallChunks
最終更新日 2026年8月24日