Skip to main content

XPackageChangeChunkInstallOrder

먼저 설치할 선택된 청크를 지정합니다.

구문

매개 변수

packageIdentifier   _In_z_
형식: char*
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스를 참조하세요. selectorCount   _In_
형식: uint32_t
selectors 매개 변수의 선택자 수입니다. selectors   _In_reads_(selectorCount)
형식: XPackageChunkSelector*
영향을 받을 청크의 유형을 지정하는 선택자 배열입니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다.

설명

이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지 않습니다. 자세한 내용은 Time-sensitive threads를 참조하세요.
XPackageChangeChunkInstallOrder는 지정된 선택자로 선택된 청크가 설치 큐의 맨 앞에 배치되도록 업데이트합니다. 이는 청크 ID 배열뿐만 아니라 선택자를 사용할 수 있습니다. 여기에 더 복잡한 선택자를 전달할 수 있으며, 이를 구성하는 청크는 모두 큐의 맨 앞으로 푸시됩니다. XPackageChangeChunkInstallOrder는 청크가 설치되지 않았을 때뿐만 아니라 언제든지 호출할 수 있습니다. 청크가 이미 설치된 경우 XPackageChangeChunkInstallOrder는 청크를 무시합니다. 인텔리전트 배달로 인해 설치가 전혀 예정되지 않은 청크를 제공하는 경우에도 마찬가지입니다. 다음 예제에서 사용자가 계속 플레이할 수 있도록 게임이 “soon”이라는 파일에 액세스해야 합니다. PrioritizeChunk 함수가 정의되고 청크의 현재 설치 상태를 확인합니다. 청크가 아직 설치되지 않은 경우 함수는 스트리밍 시스템에 청크를 설치하도록 요청하고 청크의 진행 상황을 모니터링할 수 있는 설치 모니터를 반환합니다. 청크가 이미 설치된 경우 함수는 null 모니터를 반환합니다.

요구 사항

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

개념 문서

함께 보기

XPackage
스트리밍 설치 및 인텔리전트 배달
마지막 수정일 2026년 8월 24일