Skip to main content

XGameSaveGetRemainingQuota

Retorna a quantidade de dados disponível para armazenamento usando a API XGameSave.

Sintaxe

Parâmetros

provider   _In_
Tipo: XGameSaveProviderHandle
Identificador para o XGameSaveProvider cujos dados restantes serão consultados. remainingQuota   _Out_
Tipo: int64_t*
Quantidade de dados disponível para ser usada como armazenamento.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Não é seguro chamar esta função em uma thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Cada aplicativo tem uma cota de quantos dados pode salvar para um usuário; se ela for excedida, qualquer tentativa de salvar mais dados poderá falhar com E_GS_QUOTA_EXCEEDED. Como esse não é um tamanho fixo, expusemos o acesso à cota restante para que o aplicativo possa tentar evitar falhas E_GS_QUOTA_EXCEEDED. Para fornecer uma visão precisa, sempre garantimos que quaisquer gravações, atualizações ou exclusões pendentes sejam tratadas primeiro antes de retornar, pois qualquer uma delas pode alterar a cota restante. É recomendável chamar esta função para garantir que haja uma quantidade razoável de dados restante para executar uma chamada para XGameSaveSubmitUpdate.

Requisitos

Cabeçalho: XGameSave.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XGameSave
XGameSaveSubmitUpdate
Depuração de salvamentos de jogos
Last modified on October 6, 2026