Skip to main content

XGameSaveGetRemainingQuota

返回可使用 XGameSave API 存储的可用数据量。

Syntax

Parameters

provider   _In_
类型:XGameSaveProviderHandle
要查询剩余数据的 XGameSaveProvider 的句柄。 remainingQuota   _Out_
类型:int64_t*
可用作存储的数据量。

Return value

类型:HRESULT 函数结果。

Remarks

此函数在时间敏感型线程上调用是不安全的。有关详细信息,请参阅时间敏感型线程
每个应用程序对可为一个用户保存的数据量都有配额,如果超过此配额,任何保存更多数据的尝试都可能失败并返回 E_GS_QUOTA_EXCEEDED。由于这不是一个固定大小,因此我们公开了对剩余配额的访问权限,以便应用程序可以尝试避免 E_GS_QUOTA_EXCEEDED 失败。为了提供准确的视图,我们始终确保在返回之前先处理任何未完成的写入、更新或删除操作,因为其中任何一项都可能更改剩余配额。建议你调用此函数以确保有足够的数据用于执行对 XGameSaveSubmitUpdate 的调用。

Requirements

头文件: XGameSave.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XGameSave
XGameSaveSubmitUpdate
调试游戏保存
最后修改于 2026年8月24日