Skip to main content

Microsoft.Xbox.Wrappers.XGameSave.Provider

The primary management class for the XGameSave wrapper.

Syntax

Methods

Remarks

The XGameSave simplified wrapper is a set of API’s that enable reading and writing data on behalf of a user, to be persisted across game sessions, and to seamlessly sync with the cloud across multiple devices. The wrapper APIs fall into three categories: Providers gs_provider_t is the handle that binds a user context to a game save. It’s required for API interactions. Each provider can contain multiple containers, and each provider has a default quota of 256 MB. Provider operations include:
  • Quota information
  • Container management
  • Provider Metadata (Service Configuration ID, UserContext)
Containers You can use containers to logically correlate data into a group that can be written to, updated, and read from atomically. Container operations include:
  • Queries on container info, and container status
  • Queries on container contents
  • Atomic updates to container data
Binary large objects (blobs) Blobs contain the data contained within a container. The maximum amount of data that a blob can contain is 16 MB.
  • Blob update and delete operations are designed to be atomic, so that a set of changes can be committed in one operation. If any portion fails, then the entire update fails.

Requirements

Header: xgamesavewrappers.hpp Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

See also

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave wrapper members
Observer Design Pattern
Last modified on August 20, 2026