> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XPackageUpdateInstallationMonitor

> XPackageUpdateInstallationMonitor

# XPackageUpdateInstallationMonitor

[XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress)에서 반환된 진행률을 새로 고칩니다.

## 구문

```cpp theme={null}
bool XPackageUpdateInstallationMonitor(  
         XPackageInstallationMonitorHandle installationMonitor  
)  
```

### 매개 변수

*installationMonitor*   \_In\_\
형식: XPackageInstallationMonitorHandle

업데이트할 설치 모니터에 대한 핸들입니다.

### 반환 값

형식: bool

진행률 스냅샷의 어떤 측면이라도 변경된 경우 true를 반환합니다. 그렇지 않으면 false를 반환합니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출해서는 안전하지 않습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

**XPackageUpdateInstallationMonitor**를 호출하여 [XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress)에서 반환된 진행률을 새로 고칠 수 있습니다. 설치 모니터의 새로 고침 주기가 0이 아닌 경우, 이 API는 타이머 스레드에서 새로 고침 주기에 따라 자동으로 호출됩니다. 진행률을 업데이트하는 스레드를 제어하려면 주기를 0으로 설정하고 이 함수를 직접 호출하세요. **XPackageUpdateInstallationMonitor**는 진행률 스냅샷의 어떤 측면이라도 변경된 경우 true를 반환합니다.

다음은 **XPackageUpdateInstallationMonitor**를 사용하여 설치 모니터를 수동으로 폴링하여 게임 설치가 완료되었는지 여부를 확인하는 예제입니다. 설치가 완료되면 이 코드는 모니터 핸들을 닫습니다.

```cpp theme={null}
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 콘솔

## 개념 문서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[XPackage](/reference/system/xpackage/xpackage_members)\
[스트리밍 설치 및 Intelligent Delivery](/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)\
[XPackageGetInstallationProgress](/reference/system/xpackage/functions/xpackagegetinstallationprogress)


## Related topics

- [XPackage](/ko/reference/system/xpackage/xpackage_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XPackageCreateInstallationMonitor](/ko/reference/system/xpackage/functions/xpackagecreateinstallationmonitor.md)
- [XPackageCloseInstallationMonitorHandle](/ko/reference/system/xpackage/functions/xpackagecloseinstallationmonitorhandle.md)
- [XPackageGetInstallationProgress](/ko/reference/system/xpackage/functions/xpackagegetinstallationprogress.md)