> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerStartProcessingMatchmakingStateChanges

> Récupère le tableau des changements d'état de matchmaking PlayFab Multiplayer à traiter depuis le dernier appel, ce qui permet au titre de réagir aux mises à jour des tickets et des parties.

Récupère un tableau de tous les changements d'état de matchmaking à traiter depuis le dernier appel de ce type.

## Syntaxe

```cpp theme={null}
HRESULT PFMultiplayerStartProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t* stateChangeCount,  
    const PFMatchmakingStateChange* const** stateChanges  
)  
```

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

**`stateChangeCount`**   uint32\_t\*\
*sortie*

Nombre en sortie d'entrées PFMatchmakingStateChange que le titre doit traiter dans le tableau `stateChanges`.

**`stateChanges`**   PFMatchmakingStateChange\* const\*\*\
*tableau de sortie alloué par la bibliothèque, de taille `*stateChangeCount`*

Tableau de sortie alloué par la bibliothèque contenant toutes les entrées PFMatchmakingStateChange que le titre doit traiter, puis transmettre à [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges).

### Valeur de retour

Type : HRESULT

`S_OK` si l'appel a réussi, ou un code d'erreur dans le cas contraire. La forme lisible du code d'erreur peut être récupérée au moyen de [PFMultiplayerGetErrorMessage()](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Remarques

Cette méthode donne à la bibliothèque Matchmaking l'occasion de synchroniser son é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 zéro ou plusieurs changements, pour mettre à jour son propre état ou son interface utilisateur, puis appeler rapidement [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges) avec ces changements. <br /><br /> L'état de la bibliothèque Matchmaking exposé par la bibliothèque peut changer pendant cet appel; vous devez donc l'utiliser de façon thread-safe. PFMultiplayerStartProcessingMatchmakingStateChanges() doit être appelé fréquemment, au moins une fois par image. Il est conçu pour s'exécuter et retourner rapidement, de sorte qu'il puisse être appelé sur votre thread d'interface utilisateur principal avec un impact négligeable. Pour de meilleurs résultats, réduisez également au minimum le temps consacré au traitement des changements d'état avant d'appeler PFMultiplayerFinishProcessingMatchmakingStateChanges().   <br /><br /> Chaque changement d'état retourné par PFMultiplayerStartProcessingMatchmakingStateChanges() doit être retourné à PFMultiplayerFinishProcessingMatchmakingStateChanges() exactement une fois, mais peut l'être dans le désordre et entrelacé avec des changements d'état issus d'autres appels à PFMultiplayerStartProcessingMatchmakingStateChanges(). Toutes les ressources associées à un changement d'état spécifique restent assurément valides jusqu'à ce que ce changement d'état soit retourné à PFMultiplayerFinishProcessingMatchmakingStateChanges().

## Configuration requise

**En-tête :** PFMatchmaking.h

## Voir aussi

[Membres de PFMatchmaking](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)\
[PFMatchmakingStateChange](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange)\
[PFMultiplayerFinishProcessingMatchmakingStateChanges](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)


## Related topics

- [PFMultiplayerFinishProcessingMatchmakingStateChanges](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges.md)
- [PFMatchmakingStateChange](/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange.md)
- [Guide des opérations asynchrones du SDK C++ Lobby et Matchmaking](/fr-CA/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Démarrage rapide du SDK Matchmaking](/fr-CA/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](/fr-CA/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)