XGameSave
XGameSave API は、ゲーム関連の状態の作成、読み込み、保存、および管理を可能にするために設計されています。この API とこれまでの実装との主な違いは、フラットな API を提供し、非同期プログラミング モデルへのアクセスを可能にすることで、API の動作におけるスレッド処理およびメモリ管理を呼び出し元が制御できるようにしている点です。Functions
Structures
| 構造体 | 説明 |
|---|---|
| XGameSaveBlob | XGameSave ストレージの情報単位。XGameSaveContainer 内に格納されます。 |
| XGameSaveBlobInfo | XGameSaveBlob に関する情報。 |
| XGameSaveContainerInfo | XGameSaveContainer に関する情報。 |
Error Codes
XGameSave API からは、以下のエラー コードが返される可能性があります。完全な一覧については、Error codes を参照してください。詳細なトラブルシューティング ガイダンスについては、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 の呼び出しを混在させていますが、これはサポートされていません。 |