Skip to main content

XPackageRegisterPackageInstalled

インストールが完了したときに呼び出されるコールバックを登録します。

Syntax

Parameters

queue   _In_
型: XTaskQueueHandle
コールバックを実行する非同期キュー。 context   _In_opt_
型: void*
コールバックに渡されるコンテキスト。 callback   _In_
型: XPackageInstalledCallback*
インストールが完了したときに呼び出されるユーザー定義のコールバック。 token   _Out_
型: XTaskQueueRegistrationToken*
戻り時、XPackageUnregisterPackageInstalled でコールバックを登録解除するために使用できる、コールバックを識別するトークンが含まれます。

Return value

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

Remarks

PackageInstalled 通知を使用すると、新しいパッケージが完全にインストールされたタイミングを判定できます。 XPackageEnumeratePackages API と XPackageRegisterPackageInstalled API の両方が、XPackageDetails 構造体を介してインストールの詳細を提供します。パッケージがインストール中の場合、installing プロパティは true に設定され、インストール モニターを作成して、そのパッケージの識別子でインストールの進行状況を監視できます。 汎用のインストール キュー通知はありません。処理中の項目を表示および追跡するには XPackageEnumeratePackages を使用し、新しい DLC の存在を通知するには PackageInstalled を使用することが意図されています。また、インストールを停止、開始、キャンセルする API もありません。ゲームの観点からは、インストールは自動的に処理されるはずです。エラーは自動的に再試行され、ゲームからは見えません。 次の例では、XPackageRegisterPackageInstalled を使用して、新しい DLC パッケージがインストールされたときにメッセージを出力しています。

Requirements

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

Conceptual documentation

See also

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