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 を提供できます。
Requirements
ヘッダー: XPackage.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
- インテリジェント デリバリー: カスタム タグ指定子
- インテリジェント デリバリー: 機能とレシピ
- インテリジェント デリバリー: 言語指定子
- インテリジェント デリバリー: OnDemand コンテンツ
- タイム センシティブ スレッド
