PFMultiplayerStartProcessingMatchmakingStateChanges

Artikel
07/11/2023

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

Syntax

HRESULT PFMultiplayerStartProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t* stateChangeCount,  
    const PFMatchmakingStateChange* const** stateChanges  
)

Parameter

handle PFMultiplayerHandle

Das Handle der PFMultiplayer-API instance.

stateChangeCount uint32_t*
Ausgabe

Die Ausgabenummer der PFMatchmakingStateChange-Einträge für den Titel, der stateChanges im Array behandelt werden soll.

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

Ein von der Bibliothek zugeordnetes Ausgabearray aller PFMatchmakingStateChange-Einträge, die der Titel behandeln und dann an PFMultiplayerFinishProcessingMatchmakingStateChanges()übergeben wird.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode bietet der Matchmaking-Bibliothek die Möglichkeit, den Zustand mit Remotegeräten oder -diensten zu synchronisieren, und ruft eine Liste aller Änderungen ab, die derzeit für den Titel seit dem letzten Aufruf dieser Methode 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 PFMultiplayerFinishProcessingMatchmakingStateChanges() mit ihnen rechtzeitig aufrufen.

Der Zustand der Matchmaking-Bibliothek, der von der Bibliothek verfügbar gemacht wird, kann sich während dieses Aufrufs ändern, sodass Sie bei der Verwendung threadsicher sein müssen. PFMultiplayerStartProcessingMatchmakingStateChanges() sollte häufig aufgerufen werden – mindestens einmal pro Grafikframe. 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 PFMultiplayerFinishProcessingMatchmakingStateChanges() aufrufen.

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

Voraussetzungen

Header: PFMatchmaking.h

Weitere Informationen

PFMatchmaking-Mitglieder
PFMatchmakingStateChange
PFMultiplayerFinishProcessingMatchmakingStateChanges

Freigeben über