XPackageEstimateDownloadSize
지정된 설치 선택기와 일치하는 청크의 다운로드 크기를 계산합니다.
구문
HRESULT XPackageEstimateDownloadSize(
const char* packageIdentifier,
uint32_t selectorCount,
XPackageChunkSelector* selectors,
uint64_t* downloadSize,
bool* shouldPresentUserConfirmation
)
매개 변수
packageIdentifier _In_z_
형식: char*
디스크에 설치된 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.
selectorCount _In_
형식: uint32_t
selectors 매개 변수의 선택기 수입니다.
selectors _In_reads_(selectorCount)
형식: XPackageChunkSelector*
작동할 청크를 지정하는 선택기 배열입니다.
downloadSize _Out_
형식: uint64_t*
반환 시, 지정된 설치 선택기의 다운로드 크기를 포함합니다.
shouldPresentUserConfirmation _Out_opt_
형식: bool*
다운로드 시 사용자의 확인이 필요하다면 true를 반환합니다. 그렇지 않으면 false를 반환합니다.
반환 값
형식: HRESULT
HRESULT 성공 또는 오류 코드입니다.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
제공되는 경우, shouldPresentUserConfirmation 매개 변수는 예상 다운로드 크기가 사용자에게 다운로드 크기를 수락하도록 메시지를 표시할 정도로 큰 경우에 true로 설정됩니다.
다음 예제에서는 레이스 게임의 트랙 이름을 수락하고 트랙이 설치되지 않은 경우 트랙의 다운로드 크기를 인쇄합니다.
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 콘솔