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 主机