Skip to main content

XPackageChangeChunkInstallOrder

最初にインストールする選択済みチャンクを指定します。

Syntax

Parameters

packageIdentifier   _In_z_
型: char*
ディスク上のインストール済みパッケージを一意に識別する文字列。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 selectorCount   _In_
型: uint32_t
selectors パラメーター内のセレクターの数。 selectors   _In_reads_(selectorCount)
型: XPackageChunkSelector*
影響を受けるチャンクの種類を指定するセレクターの配列。

Return value

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

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
XPackageChangeChunkInstallOrder は、指定されたセレクターによって選択されたチャンクを、インストール キューの先頭に配置するよう更新します。これはチャンク ID の配列だけでなく、セレクターも受け取ることができます。ここではより複雑なセレクターを渡すこともでき、それを構成するすべてのチャンクがキューの先頭に押し上げられます。 XPackageChangeChunkInstallOrder は、チャンクがインストールされていないときだけでなく、いつでも呼び出すことができます。チャンクが既にインストールされている場合、XPackageChangeChunkInstallOrder はそれらを無視します。インテリジェント デリバリーの結果としてインストールが予定されていないチャンクを提供した場合も同様です。 次の例では、ユーザーがプレイし続けられるよう、ゲームは “soon” というファイルにアクセスする必要があります。PrioritizeChunk 関数を定義し、チャンクの現在のインストール状態を確認します。チャンクがまだインストールされていない場合、この関数はストリーミング システムにインストールを要求し、チャンクの進行状況を監視できるインストール モニターを返します。チャンクが既にインストールされている場合、関数は null モニターを返します。

Requirements

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

Conceptual documentation

See also

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