XPackageFindChunkAvailability
지정된 선택기와 일치하는 청크의 컬렉션에 대한 최소 가용성을 반환합니다.
구문
HRESULT XPackageFindChunkAvailability(
const char* packageIdentifier,
uint32_t selectorCount,
XPackageChunkSelector* selectors,
XPackageChunkAvailability* availability
)
매개 변수
packageIdentifier _In_z_
형식: char*
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.
selectorCount _In_
형식: uint32_t
selectors 매개 변수의 선택기 수입니다.
selectors _In_reads_opt_(selectorCount)
형식: XPackageChunkSelector*
확인할 청크를 지정하는 선택기 배열입니다.
availability _Out_
형식: XPackageChunkAvailability*
반환 시, 청크의 가용성을 나열합니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
XPackageFindChunkAvailability는 청크 선택기 배열을 가져와 연결된 청크를 찾은 다음 해당 청크에 대한 최소 가용성을 반환합니다. 가용성 범위는 다음 값에 따라 다릅니다.
- 준비: 청크가 이미 설치되었고, 청크를 읽을 수 있습니다.
- 보류 중: 청크가 아직 설치되지 않았지만, 설치될 예정입니다.
- 설치할 수 있음: 청크가 아직 설치되지 않았지만, 청크를 다운로드할 수 있습니다.
- 사용할 수 없음: 청크를 다운로드할 수 없습니다.
다음 예제에서는 레이스 게임의 트랙 이름을 수락하고 트랙이 설치되지 않은 경우 트랙의 다운로드 크기를 인쇄합니다.
HRESULT ListDownloadSize(char* trackName)
{
XPackageChunkSelector selector;
selector.type = XPackageChunkSelectorType::Tag;
selector.tag = trackName;
char id[XPACKAGE_IDENTIFIER_MAX_LENGTH];
HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id);
if (FAILED(hr)) return hr;
XPackageChunkAvailability availability;
hr = XPackageFindChunkAvailability(id, 1, &selector, &availability);
if (FAILED(hr)) return hr;
if (availability == XPackageChunkAvailability::Installable)
{
uint64_t downloadSize;
hr = XPackageEstimateDownloadSize(id, 1, &selector, &downloadSize, nullptr);
if (FAILED(hr)) return hr;
printf("Download Size for track %s: %I64u\n", trackName, downloadSize);
}
return hr;
}
요구 사항
헤더: XPackage.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔