Skip to main content

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

XGameSave
XGameSaveCreateUpdate
XGameSaveSubmitBlobWrite
XGameSaveSubmitBlobDelete
Debugging Game Saves
最終更新日 2026年8月24日