Skip to main content

XGameSaveGetRemainingQuota

傳回可使用 XGameSave API 儲存的資料量。

語法

參數

provider   _In_
類型:XGameSaveProviderHandle
要查詢剩餘資料量的 XGameSaveProvider 控制代碼。 remainingQuota   _Out_
類型:int64_t*
可用作儲存空間的資料量。

傳回值

類型:HRESULT 函式結果。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
每個應用程式都有可為使用者儲存多少資料的配額,如果超過配額,任何儲存更多資料的嘗試都可能會失敗並傳回 E_GS_QUOTA_EXCEEDED。由於這不是固定大小,我們公開了剩餘配額的存取權,讓應用程式可以嘗試避免 E_GS_QUOTA_EXCEEDED 失敗。為了提供準確的檢視,我們一律會確保在傳回之前先處理任何未完成的寫入、更新或刪除,因為這些作業都可能變更剩餘配額。建議您呼叫此函式,以確保有足夠的剩餘資料量可執行 XGameSaveSubmitUpdate 呼叫。

需求

標頭: XGameSave.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XGameSave
XGameSaveSubmitUpdate
偵錯遊戲存檔
Last modified on October 6, 2026