XPackageUnregisterInstallationProgressChanged
이전에 등록된 설치 프로세스 변경 콜백을 등록 해제합니다.
구문
bool XPackageUnregisterInstallationProgressChanged(
XPackageInstallationMonitorHandle installationMonitor,
XTaskQueueRegistrationToken token,
bool wait
)
매개 변수
installationMonitor _In_
형식: XPackageInstallationMonitorHandle
지정된 콜백이 제거될 설치 모니터입니다.
token _In_
형식: XTaskQueueRegistrationToken
XPackageRegisterInstallationProgressChanged에서 반환된 토큰입니다.
wait _In_
형식: bool
보류 중인 콜백이 완료될 때까지 차단할지 여부를 나타냅니다.
반환 값
형식: bool
wait가 false이고 등록 취소가 보류 중이면 false를 반환합니다. 그렇지 않으면 true를 반환합니다.
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
알림 등록 해제는 다음과 같이 작동합니다.
- 등록된 콜백 집합에서 등록을 취소하면 토큰과 연결된 콜백이 제거됩니다.
- 해당 콜백 토큰에 대해 콜백이 실행되고 있지 않으면 호출 시 true를 반환합니다.
- 콜백이 실행 중이고 wait이 true이면 실행 중인 콜백이 완료될 때까지 호출이 차단됩니다.
- 콜백이 실행 중이고 wait false이면 호출이 차단되지 않지만, false가 반환됩니다. 토큰에 대한 콜백이 완료된 후 토큰이 자동으로 등록 취소됩니다.
이 메커니즘은 다음과 같은 코딩 패턴을 허용합니다.
- 등록 취소를 호출한 후 콜백이 호출되지 않도록 등록 취소를 차단할 수 있습니다.
- 차단하지 않도록 선택할 수 있습니다. 데이터를 삭제하기 전에 콜백이 완료되도록 하려면 wait에 대해 false를 사용하여 등록 취소를 주기적으로 호출합니다. 최종적으로 true가 반환되면 모든 콜백이 완료되고, 상태를 삭제할 수 있습니다.
- 등록 해제 호출 중 콜백이 호출되는지 여부가 중요하지 않으면, wait에 대해 false만 전달하고 반환 값을 무시할 수 있습니다.
예제:
XPackageUnregisterInstallationProgressChanged(monitor, token, false);
요구 사항
헤더: XPackage.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔