Syntaxe
Paramètres
stateChangeCount uint32_t*output Le nombre de sortie d’entrées PartyStateChange que le titre doit traiter dans le tableau
stateChanges.
stateChanges PartyStateChangeArray*library-allocated output array of size
*stateChangeCount
Un tableau de sortie alloué par la bibliothèque contenant toutes les entrées PartyStateChange que le titre doit traiter, puis transmettre à FinishProcessingStateChanges().
Valeur de retour
PartyErrorc_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 donne à la bibliothèque Party l’occasion de synchroniser l’état avec les appareils ou services distants, et récupère la liste de tous les changements actuellement disponibles pour le titre depuis le dernier appel à cette méthode. Le titre doit utiliser le tableau fourni, contenant 0 ou plusieurs changements, pour mettre à jour son propre état ou son interface utilisateur, puis appeler rapidement FinishProcessingStateChanges() avec ces changements.L’état de la bibliothèque Party exposé par la bibliothèque peut changer pendant cet appel; vous devez donc l’utiliser de façon thread-safe. Par exemple, appeler StartProcessingStateChanges() sur votre thread d’interface utilisateur pendant qu’un thread de travail distinct parcourt la liste des points de terminaison retournée par PartyNetwork::GetEndpoints() peut provoquer des plantages, car StartProcessingStateChanges() peut modifier la mémoire associée à la liste des points de terminaison. StartProcessingStateChanges() doit être appelée fréquemment, au moins une fois par image graphique. Elle est conçue pour s’exécuter et retourner rapidement, de sorte qu’elle puisse ê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 passé à traiter les changements d’état avant d’appeler FinishProcessingStateChanges().
Chaque changement d’état retourné par StartProcessingStateChanges() doit être retourné à 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 sont garanties valides jusqu’à ce que ce changement d’état soit retourné à FinishProcessingStateChanges().
Configuration requise
En-tête : Party.hVoir aussi
PartyManagerPartyStateChange
PartyManager::FinishProcessingStateChanges