Skip to main content

XPackageInstallChunks

청크 설치를 시작합니다.

구문

매개 변수

packageIdentifier   _In_z_
형식: char*
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스를 참조하세요. selectorCount   _In_
형식: uint32_t
selectors 매개 변수의 선택자 수입니다. selectors   _In_reads_(selectorCount)
형식: XPackageChunkSelector*
설치할 청크를 지정하는 선택자 배열입니다. minimumUpdateIntervalMs   _In_
형식: uint32_t
업데이트 간격(밀리초)입니다. suppressUserConfirmation   _In_
형식: bool
설치할 청크가 미리 설정된 크기를 초과하는 경우 확인 프롬프트가 표시됩니다. suppressUserConfirmation이 true인 경우 프롬프트가 표시되지 않고 사용자가 수락한 것처럼 설치가 진행됩니다. 이를 통해 게임에서 자체 UI를 표시할 수 있습니다. 게임이 이를 사용하는 경우, 사용자에게 표시될 크기를 가져오려면 XPackageEstimateDownloadSize도 호출해야 합니다. XPackageEstimateDownloadSize는 크기가 프롬프트를 표시할 정도로 큰지를 나타내는 부울도 반환합니다. 다운로드 확인이 필요한 경우, 게임은 자체 UI를 사용하여 표시하거나 XPackageInstallChunks가 표시하도록 해야 합니다. queue   _In_opt_
형식: XTaskQueueHandle
작업이 수행될 비동기 큐입니다. installationMonitor   _Out_
형식: XPackageInstallationMonitorHandle*
반환 시 선택자와 일치하는 청크의 설치를 모니터링할 설치 모니터에 대한 핸들을 포함합니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.
설치가 거부된 경우 취소 오류를 반환합니다.

설명

이 함수는 시간에 민감한 스레드에서 호출해서는 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
청크 설치에는 사용자에게 다운로드 크기를 수락하라는 메시지가 표시될 수 있습니다.
  • 이 API의 동기 버전을 사용하는 경우 사용자가 다운로드를 수락하거나 거부할 때까지 차단됩니다. 사용자가 거부하는 경우 호출은 취소 오류 E_ABORT로 실패합니다. 이를 통해 설치 상태를 모니터링하는 데 사용할 수 있는 설치 모니터가 반환됩니다. 모니터는 결국 XPackageCloseInstallationMonitorHandle을 호출하여 닫아야 합니다.
  • suppressUserConfirmation을 true로 설정하면 다운로드에 대해 사용자에게 프롬프트를 표시할 사용자 지정 UI를 제공할 수 있습니다.
이 예제에서는 “BigMaps” 태그에 해당하는 청크를 설치합니다.

요구 사항

헤더: XPackage.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XPackage
마지막 수정일 2026년 8월 24일