Skip to main content

XGameSaveReadBlobData

コンテナーの BLOB データを読み取ります。

Syntax

Parameters

container   _In_
型: XGameSaveContainerHandle
XGameSaveBlob データを含む XGameSaveContainer のハンドル。 blobNames   _In_opt_z_count_(countOfBlobs)
型: char
*
XGameSaveBlob 名を表す文字列の配列へのポインター。 countOfBlobs   _Inout_
型: uint32_t*
読み取る BLOB の数。 blobsSize   _In_
型: size_t
割り当てられた BLOB データのサイズ。BLOB メタデータの読み取りから推定できます。 blobData   _Out_writes_bytes_(blobsSize)
型: XGameSaveBlob*
BLOB データを含む XGameSaveBlob ポインター。コンテナーから要求されたすべての BLOB を格納するためのメモリを割り当てておく必要があります。

Return value

型: HRESULT 関数の結果。

Common errors

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_PROVIDED_BUFFER_TOO_SMALL
  • E_GS_BLOB_NOT_FOUND
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

Remarks

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
この関数を使用して、ゲーム セーブ BLOB のデータを読み取ります。関数は、BLOB コンテナー内の BLOB の数とデータを返します。これらを使用してコンテナー内の BLOB を反復処理し、適切な情報を読み取ることができます。この関数には、XGameSaveReadBlobDataAsync と呼ばれる非同期バージョンがあります。

Requirements

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

Conceptual documentation

See also

XGameSave
XGameSaveBlobInfo
XGameSaveReadBlobDataAsync
Debugging Game Saves
最終更新日 2026年8月24日