次の方法で共有


XGameSaveGetRemainingQuotaAsync

XGameSave API を非同期的に使用して保存するために使用できるデータ量を返します。

構文

HRESULT XGameSaveGetRemainingQuotaAsync(  
         XGameSaveProviderHandle provider,  
         XAsyncBlock* async  
)  

パラメーター

provider _In_
型: XGameSaveProviderHandle

残りのデータを照会するための XGameSaveProvider へのハンドル。

async _In_
型: XAsyncBlock*

呼び出し元のコンテキストとコールバック関数が格納されている AsyncBlock。

戻り値

型: HRESULT

関数の結果です。

解説

結果と残りのクォータは、XGameSaveGetRemainingQuotaResult 関数から取得します。

各アプリケーションにはユーザー用に保存できるデータの量に対するクォータがあり、それを超過すると、それ以上データを保存しようとしても、E_GS_QUOTA_EXCEEDED で失敗する可能性があります。 これは固定サイズではないので、残りのクォータへのアクセスが公開されていて、アプリケーションでは E_GS_QUOTA_EXCEEDED による失敗を回避できます。 未処理の書き込み、更新、削除があると、残りのクォータが変化する可能性があるため、正確な値が得られるよう、常にこれらを先に処理してから、値が返されます。

要件

ヘッダー: XGameSave.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XGameSave
XGameSaveGetRemainingQuotaResult
ゲームのセーブ エラー