XPersistentLocalStoragePromptUserForSpaceAsync
タイトルは、拡大可能な永続ローカル ストレージの要求された合計バイト数を解放するようユーザーに通知することができます。
構文
HRESULT XPersistentLocalStoragePromptUserForSpaceAsync(
uint64_t requestedBytes,
XAsyncBlock* asyncBlock
)
パラメーター
requestedBytes _In_
型: uint64_t
タイトルが使用できるようにする領域の合計。
asyncBlock _Inout_
型: XAsyncBlock*
非同期呼び出しのステータスを監視するための XAsyncBlock。
戻り値
型: HRESULT
成功した場合は S_OK を返し、それ以外の場合はエラー コードを返します。 エラー コードの一覧については、「エラー コード」を参照してください。
解説
呼び出す前に、XPersistentLocalStorageGetSpaceInfo を使用して空き領域を確認する必要があります。
XPersistentLocalStoragePromptUserForSpaceResult を呼び出すことにより、要求の結果をコールバック関数内で確認する必要があります。 これは、要求されたバイト数をユーザーが解放したことを保証するものではありません。ユーザーが操作を実行したことだけが保証されます。 ユーザーが領域の要求を行った操作を再試行すると、ゲームは XPersistentLocalStorageGetSpaceInfo を使用して空き領域をもう一度クエリします。 ユーザーが領域を解放しないことを選択した場合、非同期操作の結果は E_ABORT です。
永続ローカル ストレージは PC プラットフォームに実装されていません。 存在する場合でも、このメソッドは PC で使用しないでください。
これは、データセンターのストリーミング サーバーでは無効になっています。 データセンターのストリーミング サーバーで呼び出されると、常に E_ABORT が返されます。
要件
ヘッダー: XPersistentLocalStorage.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体