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 콘솔