Skip to main content

XPackageFindChunkAvailability

지정된 선택자와 일치하는 청크 컬렉션의 최소 가용성을 반환합니다.

구문

매개 변수

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

반환 값

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

설명

이 함수는 시간에 민감한 스레드에서 호출해서는 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XPackageFindChunkAvailability는 청크 선택자 배열을 받아 연관된 청크를 찾은 다음 해당 청크의 최소 가용성을 반환합니다. 가용성 범위는 다음 값에 따라 결정됩니다.
  • Ready: 청크가 이미 설치되어 있고 읽을 수 있습니다.
  • Pending: 청크가 아직 설치되지 않았지만 설치될 예정입니다.
  • Installable: 청크가 설치되지는 않지만 다운로드할 수 있습니다.
  • Unavailable: 청크를 다운로드할 수 없습니다.
다음 예제에서는 레이싱 게임의 트랙 이름을 받아 트랙이 설치되어 있지 않은 경우 해당 트랙의 다운로드 크기를 출력합니다.

요구 사항

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

개념 문서

함께 보기

XPackage
스트리밍 설치 및 Intelligent Delivery
마지막 수정일 2026년 8월 24일