PFMultiplayerFinishProcessingMatchmakingStateChanges

Artikel
07/11/2023

Gibt ein Array von Matchmaking-Zustandsänderungen zurück, die verarbeitet wurden.

Syntax

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

Parameter

handle PFMultiplayerHandle

Das Handle der PFMultiplayer-API instance.

stateChangeCount uint32_t

Die Anzahl der Änderungen, die in der von stateChangesangegebenen Liste angegeben wurden, die zuvor von PFMultiplayerStartProcessingMatchmakingStateChanges() zurückgegeben wurden, die jetzt vom Titel verarbeitet wurden.

stateChanges PFMatchmakingStateChange* const*
Eingabearray der Größe stateChangeCount

Das Array von Änderungen, die zuvor von PFMultiplayerStartProcessingMatchmakingStateChanges() zurückgegeben wurden, die jetzt vom Titel verarbeitet wurden.

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 informiert die Matchmaking-Bibliothek darüber, dass die zustandsänderungen, die von einem vorherigen Aufruf von PFMultiplayerStartProcessingMatchmakingStateChanges() gemeldet wurden, nun vom Titel verarbeitet wurden, sodass die zugeordneten Ressourcen freigegeben werden können. Sie können PFMultiplayerFinishProcessingMatchmakingStateChanges() mit einer beliebigen Anzahl von Zustandsänderungen 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.

Um optimale Ergebnisse zu erzielen, sollten Sie die Zeit für die Verarbeitung von Zustandsänderungen minimieren, bevor Sie PFMultiplayerFinishProcessingMatchmakingStateChanges() aufrufen.

Voraussetzungen

Header: PFMatchmaking.h

Weitere Informationen

PFMatchmaking-Mitglieder
PFMatchmakingStateChange
PFMultiplayerStartProcessingMatchmakingStateChanges

Freigeben über