XGameSaveSubmitUpdateAsync
XGameSave サービスに更新を非同期で送信します。コンテナー内の BLOB を更新します。Syntax
Parameters
updateContext _In_型: XGameSaveUpdateHandle 更新対象の XGameSaveUpdate へのハンドル。 async _In_
型: XAsyncBlock* XGameSaveSubmitUpdateAsync 呼び出しの呼び出しコンテキストおよびコールバック関数を含む AsyncBlock。
Return value
型: HRESULT 関数の結果。Remarks
この関数は、XGameSaveSubmitUpdateAsync の AsyncBlock 呼び出し関数の一部として呼び出されます。この関数は XGameSaveSubmitUpdateAsync の結果を確認するために使用されます。 この API のストレージ部分は、ゲームから永続化されたストレージへのデータ転送を安全かつ信頼性が高くトランザクション処理可能な方法で簡単に行えるように設計されています。コンテナーの基となるデータは常に一貫した状態を保つ必要があるため、操作全体がアトミックに成功または失敗するようにします。BLOB データの一部がコンテナー内の他のデータと不整合を起こすような部分的な更新は望ましくありません。これを実現するために、BLOB の書き込みや削除を送信する更新コンテキストを提供し、準備が整うとコンテキスト全体を送信します。実際には次のようになります。 XGameSaveSubmitBlobWrite および XGameSaveSubmitBlobDelete を使用して、コンテナー内の BLOB に対して実行する書き込みおよび削除アクションを XGameSaveUpdate に登録します。更新は XGameSaveSubmitUpdateAsync を呼び出すことで完了します。 XGameSaveUpdate の使用が終わったら、XGameSaveCloseUpdate メソッドを使用して閉じます。 次の C++ サンプルは、非同期の XGameSave 更新を示しています。Requirements
ヘッダー: XGameSave.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体Conceptual documentation
See also
XGameSaveXGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Debugging Game Saves
