> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSave

> XGameSave

# XGameSave

XGameSave API は、ゲーム関連の状態の作成、読み込み、保存、および管理を可能にするために設計されています。この API とこれまでの実装との主な違いは、フラットな API を提供し、非同期プログラミング モデルへのアクセスを可能にすることで、API の動作におけるスレッド処理およびメモリ管理を呼び出し元が制御できるようにしている点です。

## Functions

| 関数                                                                                                                   | 説明                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| [XGameSaveBlobInfoCallback](/reference/system/xgamesave/functions/xgamesaveblobinfocallback)                         | [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) の結果を取得するためのコールバック関数。                           |
| [XGameSaveCloseContainer](/reference/system/xgamesave/functions/xgamesaveclosecontainer)                             | XGameSaveContainer を閉じます。                                                                                                                     |
| [XGameSaveCloseProvider](/reference/system/xgamesave/functions/xgamesavecloseprovider)                               | XGameSaveProvider が保持するリソースを解放します。                                                                                                            |
| [XGameSaveCloseUpdate](/reference/system/xgamesave/functions/xgamesavecloseupdate)                                   | XGameSaveUpdate を閉じます。                                                                                                                        |
| [XGameSaveContainerInfoCallback](/reference/system/xgamesave/functions/xgamesavecontainerinfocallback)               | [XGameSaveGetContainerInfo](/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) への呼び出しのコールバック関数。                                 |
| [XGameSaveCreateContainer](/reference/system/xgamesave/functions/xgamesavecreatecontainer)                           | XGameSaveContainer ハンドルを作成します。                                                                                                                |
| [XGameSaveCreateUpdate](/reference/system/xgamesave/functions/xgamesavecreateupdate)                                 | 更新を作成します。この更新は後で [XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate) を呼び出すことで送信されます。                         |
| [XGameSaveDeleteContainer](/reference/system/xgamesave/functions/xgamesavedeletecontainer)                           | クラウド ストレージから XGameSaveContainer を削除します。                                                                                                       |
| [XGameSaveDeleteContainerAsync](/reference/system/xgamesave/functions/xgamesavedeletecontainerasync)                 | XGameSaveContainer を非同期に削除します。                                                                                                                |
| [XGameSaveDeleteContainerResult](/reference/system/xgamesave/functions/xgamesavedeletecontainerresult)               | [XGameSaveDeleteContainerAsync](/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) 呼び出しの結果を取得します。呼び出しの成否を確認するためにこの関数を使用します。 |
| [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo)                       | XGameSaveContainer の内容の BLOB 情報を取得します。                                                                                                        |
| [XGameSaveEnumerateBlobInfoByName](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname)           | blobNamePrefix パラメーターと共通のプレフィックスを持つ BLOB に限定して、XGameSaveContainer の内容の BLOB 情報を取得します。                                                         |
| [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)             | XGameSaveProvider のコンテナー情報を取得します。                                                                                                             |
| [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) | XGameSaveProvider のコンテナー情報を取得します。                                                                                                             |
| [XGameSaveGetContainerInfo](/reference/system/xgamesave/functions/xgamesavegetcontainerinfo)                         | XGameSaveProvider 内のコンテナーに関する情報を取得します。                                                                                                        |
| [XGameSaveGetRemainingQuota](/reference/system/xgamesave/functions/xgamesavegetremainingquota)                       | XGameSave API を使用して保存できるデータ量を返します。                                                                                                            |
| [XGameSaveGetRemainingQuotaAsync](/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync)             | XGameSave API を使用して保存できるデータ量を非同期に返します。                                                                                                        |
| [XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult)           | [XGameSaveGetRemainingQuotaAsync](/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) 関数の結果を取得します。                         |
| [XGameSaveInitializeProvider](/reference/system/xgamesave/functions/xgamesaveinitializeprovider)                     | XGameSave プロバイダー ハンドルを提供および初期化します。                                                                                                            |
| [XGameSaveInitializeProviderAsync](/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync)           | XGameSave プロバイダー ハンドルを非同期に提供および初期化します。                                                                                                        |
| [XGameSaveInitializeProviderResult](/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult)         | [XGameSaveInitializeProviderAsync](/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) 呼び出しの結果が格納されます。                    |
| [XGameSaveReadBlobData](/reference/system/xgamesave/functions/xgamesavereadblobdata)                                 | コンテナーの BLOB データを読み取ります。                                                                                                                       |
| [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync)                       | XGameSaveContainer から XGameSaveBlob データを非同期に読み取ります。                                                                                           |
| [XGameSaveReadBlobDataResult](/reference/system/xgamesave/functions/xgamesavereadblobdataresult)                     | [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 呼び出しの結果を取得します。                                 |
| [XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete)                         | ゲーム セーブの XGameSaveUpdate に削除アクションを追加します。                                                                                                      |
| [XGameSaveSubmitBlobWrite](/reference/system/xgamesave/functions/xgamesavesubmitblobwrite)                           | XGameSaveUpdate に書き込みアクションを追加します。                                                                                                             |
| [XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate)                                 | XGameSave サービスに更新を送信します。コンテナー内の BLOB を更新します。                                                                                                  |
| [XGameSaveSubmitUpdateAsync](/reference/system/xgamesave/functions/xgamesavesubmitupdateasync)                       | XGameSave サービスに更新を非同期に送信します。コンテナー内の BLOB を更新します。                                                                                              |
| [XGameSaveSubmitUpdateResult](/reference/system/xgamesave/functions/xgamesavesubmitupdateresult)                     | [XGameSaveSubmitUpdateAsync](/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) 呼び出しの結果を取得します。                                 |

## Structures

| 構造体                                                                                  | 説明                                                |
| ------------------------------------------------------------------------------------ | ------------------------------------------------- |
| [XGameSaveBlob](/reference/system/xgamesave/structs/xgamesaveblob)                   | XGameSave ストレージの情報単位。XGameSaveContainer 内に格納されます。 |
| [XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo)           | XGameSaveBlob に関する情報。                             |
| [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) | XGameSaveContainer に関する情報。                        |

## Error Codes

XGameSave API からは、以下のエラー コードが返される可能性があります。完全な一覧については、[Error codes](/reference/errorcodes) を参照してください。詳細なトラブルシューティング ガイダンスについては、[Game Saves Debugging](/build/core-features/common/game-save/game-saves-debugging) を参照してください。

| コード                                       | 値          | 説明                                                                                |
| ----------------------------------------- | ---------- | --------------------------------------------------------------------------------- |
| E\_GS\_INVALID\_CONTAINER\_NAME           | 0x80830001 | コンテナー名が無効です。有効なコンテナー名の文字には、英大文字/英小文字、数字、アンダースコア、スラッシュが含まれます。                      |
| E\_GS\_NO\_ACCESS                         | 0x80830002 | タイトルがコンテナー ストレージ領域へのアクセス権を持たないため、操作に失敗しました。SCID と TitleId が正しく構成されていることを確認してください。 |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE            | 0x80830003 | デバイスにゲームを保存するのに十分なストレージ容量がありません。                                                  |
| E\_GS\_USER\_CANCELED                     | 0x80830004 | ユーザーがセーブ ゲームのダウンロードをキャンセルしました。                                                    |
| E\_GS\_UPDATE\_TOO\_BIG                   | 0x80830005 | セーブ更新のサイズが大きすぎます。XGameSave 更新の合計サイズは GS\_MAX\_BLOB\_SIZE (16 MB) 未満である必要があります。    |
| E\_GS\_QUOTA\_EXCEEDED                    | 0x80830006 | このユーザーのタイトルのストレージ クォータを超えました。                                                     |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL       | 0x80830007 | API に提供されたバッファーが小さすぎました。                                                          |
| E\_GS\_BLOB\_NOT\_FOUND                   | 0x80830008 | 指定された BLOB が見つかりません。                                                              |
| E\_GS\_NO\_SERVICE\_CONFIGURATION         | 0x80830009 | タイトルがコネクテッド ストレージ用に適切に構成されていません。SCID が正しく、タイトルがパートナー センターで構成されていることを確認してください。     |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC           | 0x8083000A | コンテナーがまだ同期されていません。更新を送信する前に XGameSave コンテナーが同期されていることを確認してください。                   |
| E\_GS\_CONTAINER\_SYNC\_FAILED            | 0x8083000B | コンテナーの同期に失敗しました。                                                                  |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | ユーザーの MSA がまだ XBOX サービス アカウントになっていません。                                            |
| E\_GS\_HANDLE\_EXPIRED                    | 0x8083000D | 関数で使用されるハンドルの有効期限が切れたため、再取得する必要があります。                                             |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED          | 0x8083000E | この同期関数が時間制約のあるスレッドで呼び出されており、デッドロックのリスクがあります。代わりに非同期実装を使用してください。                   |
| E\_GS\_PROVIDER\_MISMATCH                 | 0x8083000F | ゲームが XGameSave と XGameSaveFiles の呼び出しを混在させていますが、これはサポートされていません。                   |

## Conceptual documentation

* [Game Saves overview](/build/core-features/common/game-save/game-saves-overview)
* [XGameSave guide](/build/core-features/common/game-save/xgamesave)
* [Game Saves debugging](/build/core-features/common/game-save/game-saves-debugging)

## See also

[System API reference](/reference/system/gc-reference-system-toc)


## Related topics

- [Save](/ja-jp/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave API の概要](/ja-jp/build/core-features/common/game-save/xgamesave.md)
- [XGameSaveBlob](/ja-jp/reference/system/xgamesave/structs/xgamesaveblob.md)
- [XGameSaveFiles](/ja-jp/reference/system/xgamesavefiles/xgamesavefiles_members.md)
- [XGameSaveSubmitUpdate](/ja-jp/reference/system/xgamesave/functions/xgamesavesubmitupdate.md)
