PartyXblManager::StartProcessingStateChanges

Artikel
07/11/2023

Ruft ein Array aller Party-Xbox Live-Zustandsänderungen ab, die seit dem letzten Aufruf verarbeitet werden sollen.

Syntax

PartyError StartProcessingStateChanges(  
    uint32_t* stateChangeCount,  
    PartyXblStateChangeArray* stateChanges  
)

Parameter

stateChangeCount uint32_t*
Ausgabe

Ein Ort zum Schreiben der Anzahl von PartyXblStateChange-Einträgen für den Titel, der stateChanges im Array behandelt werden soll.

stateChanges PartyXblStateChangeArray*
Von der Bibliothek zugewiesenes Ausgabearray der Größe *stateChangeCount

Ein Ort, an dem ein Zeiger auf das Array aller PartyXblStateChange-Einträge für den zu behandelnden Titel gespeichert und dann an FinishProcessingStateChanges() übergeben wird.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über GetErrorMessage() abgerufen werden.

Hinweise

Diese Methode bietet der Party Xbox Live Helper-Bibliothek die Möglichkeit, eine Liste aller Änderungen abzurufen, die seit dem letzten Aufruf dieser Methode derzeit für den Titel verfügbar sind. Der Titel sollte das bereitgestellte Array von 0 oder mehr Änderungen verwenden, um seinen eigenen Zustand oder seine Benutzeroberfläche zu aktualisieren, und dann FinishProcessingStateChanges() mit ihnen rechtzeitig aufrufen.

Der zustand, der von der Bibliothek verfügbar gemacht wird, kann sich während dieses Aufrufs ändern, sodass Sie ihn threadsicher verwenden müssen. StartProcessingStateChanges() sollte häufig aufgerufen werden– mindestens einmal alle 100 Millisekunden. Es ist so konzipiert, dass er schnell ausgeführt und zurückgegeben wird, sodass er in Ihrem Standard UI-Thread mit vernachlässigbaren Auswirkungen aufgerufen werden kann. Um optimale Ergebnisse zu erzielen, sollten Sie auch die Zeit für die Verarbeitung von Zustandsänderungen minimieren, bevor Sie FinishProcessingStateChanges() aufrufen.

Jede von StartProcessingStateChanges() zurückgegebene Zustandsänderung muss genau einmal an FinishProcessingStateChanges() zurückgegeben werden, kann jedoch in der richtigen Reihenfolge zurückgegeben werden und kann mit Zustandsänderungen von anderen Aufrufen von StartProcessingStateChanges() überlappen. Alle Ressourcen, die einer bestimmten Zustandsänderung zugeordnet sind, bleiben garantiert gültig, bis die Zustandsänderung an FinishProcessingStateChanges() zurückgegeben wird.

Voraussetzungen

Header: PartyXboxLive.h

Weitere Informationen

PartyXblManager
PartyXblStateChange
PartyXblManager::FinishProcessingStateChanges

Freigeben über