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 本体