Skip to main content

XPackageFindChunkAvailability

指定されたセレクターに一致するチャンクのコレクションに対して、最小の利用可能性を返します。

Syntax

Parameters

packageIdentifier   _In_z_
型: char*
ディスク上のインストール済みパッケージを一意に識別する文字列。パッケージ識別子の詳細については、ダウンロード可能なコンテンツ (DLC) の管理およびライセンス を参照してください。 selectorCount   _In_
型: uint32_t
selectors パラメーター内のセレクターの数。 selectors   _In_reads_opt_(selectorCount)
型: XPackageChunkSelector*
チェック対象のチャンクを指定するセレクターの配列。 availability   _Out_
型: XPackageChunkAvailability*
戻り時、チャンクの利用可能性を一覧表示します。

Return value

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

Remarks

この関数はタイム センシティブ スレッドで呼び出すのは安全ではありません。詳細については、タイム センシティブ スレッド を参照してください。
XPackageFindChunkAvailability はチャンク セレクターの配列を受け取り、関連するチャンクを検索し、それらのチャンクに対する最小の利用可能性を返します。利用可能性は次の値の範囲で表されます:
  • Ready: チャンクは既にインストールされており、読み取り可能です。
  • Pending: チャンクはまだインストールされていませんが、インストールされる予定です。
  • Installable: チャンクはインストールされていませんが、ダウンロード可能です。
  • Unavailable: チャンクはダウンロードできません。
次の例は、レース ゲームのトラック名を受け取り、そのトラックがインストールされていない場合、トラックのダウンロード サイズを出力します:

Requirements

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

Conceptual documentation

See also

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