XGameSaveSubmitBlobWrite

XGameSaveUpdate に書き込みアクションを追加します。

Syntax

HRESULT XGameSaveSubmitBlobWrite(  
         XGameSaveUpdateHandle updateContext,  
         const char* blobName,  
         const uint8_t* data,  
         size_t byteCount  
)  

Parameters

updateContext   _In_
型: XGameSaveUpdateHandle BLOB の書き込み先となる XGameSaveUpdate へのハンドル。 blobName   _In_z_
型: char* 書き込む BLOB の名前。BLOB 名のサイズは GS_MAX_BLOB_NAME_SIZE バイトを超えてはなりません。 data   _In_reads_bytes_(byteCount)
型: uint8_t* BLOB に書き込むデータ。 byteCount   _In_
型: size_t BLOB に書き込むデータのサイズ。BLOB データのサイズは GS_MAX_BLOB_SIZE バイトを超えてはなりません。

BLOB データのサイズが GS_MAX_BLOB_SIZE に制限されるのと同様に、更新全体も GS_MAX_BLOB_SIZE に制限されます。更新に GS_MAX_BLOB_SIZE の BLOB が含まれる場合、追加の更新は別の更新要求として行う必要があります。

Return value

型: HRESULT 関数の結果。

Remarks

この関数は、時間制約のあるスレッドで呼び出すには安全ではありません。詳細については、時間制約のあるスレッドを参照してください。

この呼び出しを行う前に、XGameSaveCreateUpdate を正常に呼び出す必要があります。この API のストレージ部分は、ゲームから永続化されたストレージへのデータ転送を安全かつ信頼性が高くトランザクション処理可能な方法で簡単に行えるように設計されています。コンテナーの基となるデータは常に一貫した状態を保つ必要があるため、操作全体がアトミックに成功または失敗するようにします。BLOB データの一部がコンテナー内の他のデータと不整合を起こすような部分的な更新は望ましくありません。これを実現するために、BLOB の書き込みや削除を送信する更新コンテキストを提供し、準備が整うとコンテキスト全体を送信します。1 つの更新コンテキストでは、BLOB あたり 1 つの変更/削除しか書き込めない点に注意してください。実際には次のようになります。 XGameSaveSubmitBlobWrite および XGameSaveSubmitBlobDelete を使用して、コンテナー内の BLOB に対して実行する書き込みおよび削除アクションを XGameSaveUpdate に登録します。更新は XGameSaveSubmitUpdate を呼び出すことで完了します。使用例については、XGameSaveCreateUpdate の例を参照してください。

Requirements

ヘッダー: XGameSave.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

時間制約のあるスレッド

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XGameSaveSubmitBlobWrite

XGameSaveSubmitBlobWrite

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also

​XGameSaveSubmitBlobWrite

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​Conceptual documentation

​See also

XGameSaveSubmitBlobWrite

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also