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 renvoyée
PartyErrorc_partyErrorSuccess si l’appel a réussi ; sinon, un code d’erreur. La forme lisible du code d’erreur peut être obtenue via 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 manière 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 renvoyé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 renvoyé par StartProcessingStateChanges() doit être renvoyé à FinishProcessingStateChanges() exactement une fois, mais peut être renvoyé 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 renvoyé à FinishProcessingStateChanges().
Configuration requise
En-tête : Party.hVoir aussi
PartyManagerPartyStateChange
PartyManager::FinishProcessingStateChanges