XGameSaveGetRemainingQuota
XGameSave api를 사용하여 저장하기 위해 사용할 수 있는 데이터 양을 반환합니다.
구문
HRESULT XGameSaveGetRemainingQuota(
XGameSaveProviderHandle provider,
int64_t* remainingQuota
)
매개 변수
provider _In_
형식: XGameSaveProviderHandle
남은 데이터를 쿼리하는 XGameSaveProvider에 대한 핸들입니다.
remainingQuota _Out_
형식: int64_t*
저장소로 사용할 수 있는 데이터 양입니다.
반환 값
형식: HRESULT
함수 결과입니다.
설명
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
각 응용 프로그램에는 사용자에 대해 저장할 수 있는 데이터 양에 대한 할당량이 있습니다. 이 할당량이 초과되었을 때 데이터를 더 저장하려고 시도하면 E_GS_QUOTA_EXCEEDED와 함께 작업이 실패합니다. 이 크기는 고정된 크기가 아니기 때문에 응용 프로그램이 E_GS_QUOTA_EXCEEDED 오류 방지를 위해 시도할 수 있는 남은 할당량에 대한 액세스가 노출되어 있습니다. 정확한 보기를 제공하기 위해서는 남은 할당량이 변경될 수 있으므로, 항상 반환 전에 모든 미해결된 쓰기, 업데이트 또는 삭제가 처리되었는지 확인합니다. XGameSaveSubmitUpdate 호출을 실행하기 전 남은 데이터 양이 합리적인지 확인할 수 있도록 이 함수를 호출하는 것이 좋습니다.
void Sample::_GetQuotaSync(uint64_t* remainingQuota)
{
HRESULT hr = XGameSaveGetRemainingQuota(_provider, remainingQuota);
if (FAILED(hr))
{
printf("Error retrieving Quota hr=0x%08x\n", hr);
}
}
요구 사항
헤더: XGameSave.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔