Passer au contenu principal
Récupère un tableau de tous les changements d’état Party XBOX Live à traiter depuis le dernier appel de ce type.

Syntaxe

Paramètres

stateChangeCount   uint32_t*
output
Emplacement où écrire le nombre d’entrées PartyXblStateChange que le titre doit gérer dans le tableau stateChanges. stateChanges   PartyXblStateChangeArray*
library-allocated output array of size *stateChangeCount
Emplacement où stocker un pointeur vers le tableau de toutes les entrées PartyXblStateChange que le titre doit gérer, puis transmettre à FinishProcessingStateChanges().

Valeur retournée

PartyError c_partyErrorSuccess si l’appel a réussi; sinon, un code d’erreur. La forme lisible du code d’erreur peut être obtenue au moyen de GetErrorMessage().

Remarques

Cette méthode permet à la bibliothèque Party XBOX Live Helper de récupérer une liste de tous les changements actuellement disponibles pour le titre depuis le dernier appel à cette méthode. Le titre doit utiliser le tableau fourni de 0 changement ou plus pour mettre à jour son propre état ou son interface utilisateur, puis appeler FinishProcessingStateChanges() avec ceux-ci dans les meilleurs délais.

L’état exposé par la bibliothèque peut changer pendant cet appel; vous devez donc l’utiliser de façon thread-safe. StartProcessingStateChanges() doit être appelée fréquemment, au moins une fois toutes les 100 millisecondes. Elle est conçue pour s’exécuter et retourner rapidement, de sorte qu’elle peut être appelée sur votre thread d’interface utilisateur principal avec un impact négligeable. Pour de meilleurs résultats, vous devez également réduire au minimum le temps consacré à la gestion des changements d’état avant d’appeler FinishProcessingStateChanges().

Chaque changement d’état retourné par StartProcessingStateChanges() doit être renvoyé à FinishProcessingStateChanges() exactement une fois, mais peut être retourné dans le désordre et entrelacé avec des changements d’état provenant d’autres appels à StartProcessingStateChanges(). Toutes les ressources associées à un changement d’état spécifique restent valides jusqu’à ce que ce changement d’état soit renvoyé à FinishProcessingStateChanges().

Configuration requise

En-tête : PartyXboxLive.h

Voir aussi

PartyXblManager
PartyXblStateChange
PartyXblManager::FinishProcessingStateChanges
Dernière modification le 8 octobre 2026