次の方法で共有

XPackageUpdateInstallationMonitor

  • [アーティクル]

XPackageGetInstallationProgress から返される進行状況を更新します。

構文

bool XPackageUpdateInstallationMonitor(  
         XPackageInstallationMonitorHandle installationMonitor  
)

パラメーター

installationMonitor_In_
型: XPackageInstallationMonitorHandle

更新するインストール モニターのハンドル。

戻り値

型: bool

進行状況スナップショットのどこかが変わっている場合、true が返されます。 それ以外の場合は、false が返されます。

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

XPackageUpdateInstallationMonitor を呼び出して、XPackageGetInstallationProgress から返された進行状況を更新できます。 インストール モニターの更新間隔が 0 でない場合、この API はタイマー スレッドから更新間隔で自動的に呼び出されます。 進行状況を更新するスレッドを制御するには、間隔を 0 に設定し、これを自分で呼び出します。 XPackageUpdateInstallationMonitor では、進行状況スナップショットのどこかが変わっている場合は true が返されます。

XPackageUpdateInstallationMonitor を使用して、手動でインストール モニターをポーリングし、ゲームのインストールが完了したかどうかを判断する例を以下に示します。 インストールが完了すると、このコードはモニター ハンドルを閉じます。

bool CheckIfInstalled(XPackageInstallationMonitorHandle monitor)
{
    XPackageInstallationProgress progress;
    XPackageGetInstallationProgress(monitor, &progress);

    if (!progress.completed && XPackageUpdateInstallationMonitor(monitor))
    {
        XPackageGetInstallationProgress(monitor, &progress);
    }

    if (progress.completed)
    {
        XPackageCloseInstallationMonitorHandle(monitor);
    }

    return progress.completed;
}

要件

ヘッダー: XPackage.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XPackage
ストリーミング インストールとインテリジェント配信
XPackageGetInstallationProgress