XGameSaveGetRemainingQuota

Syntaxe

HRESULT XGameSaveGetRemainingQuota(  
         XGameSaveProviderHandle provider,  
         int64_t* remainingQuota  
)  

Paramètres

provider _In_
Type : XGameSaveProviderHandle

Handle vers le XGameSaveProvider pour lequel interroger l’espace de données restant.

remainingQuota _Out_
Type : int64_t*

Quantité de données disponible pour le stockage.

Valeur de retour

Type : HRESULT

Résultat de la fonction.

Remarques

Cette fonction ne peut pas être appelée sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.

Chaque application dispose d’un quota sur la quantité de données qu’elle peut enregistrer pour un utilisateur ; si ce quota est dépassé, toute tentative d’enregistrement de données supplémentaires peut échouer avec E_GS_QUOTA_EXCEEDED. Comme il ne s’agit pas d’une taille fixe, nous exposons l’accès au quota restant afin que l’application puisse essayer d’éviter les échecs E_GS_QUOTA_EXCEEDED. Pour fournir une vue précise, nous nous assurons toujours que les écritures, mises à jour ou suppressions en attente sont traitées avant le retour, car chacune d’elles peut modifier le quota restant. Il est recommandé d’appeler cette fonction pour vérifier qu’il reste une quantité de données raisonnable avant d’exécuter un appel à XGameSaveSubmitUpdate.

void Sample::_GetQuotaSync(uint64_t* remainingQuota) 
{ 
    HRESULT hr = XGameSaveGetRemainingQuota(_provider, remainingQuota); 
    if (FAILED(hr)) 
    { 
        printf("Error retrieving Quota hr=0x%08x\n", hr); 
    } 
} 

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XGameSaveGetRemainingQuota

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​XGameSaveGetRemainingQuota

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

XGameSaveGetRemainingQuota

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi