> ## 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

> Recupera a matriz de alterações de estado de matchmaking do PlayFab Multiplayer a serem processadas desde a última chamada, permitindo que o título responda às atualizações de tíquetes e partidas.

Recupera uma matriz de todas as alterações de estado de matchmaking a serem processadas desde a última chamada desse tipo.

## Sintaxe

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

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

**`stateChangeCount`**   uint32\_t\*\
*saída*

O número de saída de entradas PFMatchmakingStateChange que o título deve tratar na matriz `stateChanges`.

**`stateChanges`**   PFMatchmakingStateChange\* const\*\*\
*matriz de saída alocada pela biblioteca de tamanho `*stateChangeCount`*

Uma matriz de saída alocada pela biblioteca de todas as entradas PFMatchmakingStateChange que o título deve tratar e depois passar para [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges).

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentários

Este método oferece à biblioteca de Matchmaking a oportunidade de sincronizar o estado com dispositivos ou serviços remotos e recupera uma lista de todas as alterações disponíveis no momento para o título desde a última chamada a este método. O título deve usar a matriz fornecida de 0 ou mais alterações para atualizar o próprio estado ou a interface do usuário e, em seguida, chamar [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges) com elas em tempo hábil. <br /><br /> O estado da biblioteca de Matchmaking exposto pela biblioteca pode mudar durante esta chamada, portanto você precisa usá-lo de forma thread-safe. PFMultiplayerStartProcessingMatchmakingStateChanges() deve ser chamado com frequência, pelo menos uma vez por quadro gráfico. Ele foi projetado para ser executado e retornar rapidamente, de modo que possa ser chamado no thread principal da interface do usuário com impacto insignificante. Para obter melhores resultados, você também deve minimizar o tempo gasto no tratamento das alterações de estado antes de chamar PFMultiplayerFinishProcessingMatchmakingStateChanges().   <br /><br /> Cada alteração de estado retornada por PFMultiplayerStartProcessingMatchmakingStateChanges() precisa ser devolvida a PFMultiplayerFinishProcessingMatchmakingStateChanges() exatamente uma vez, mas pode ser devolvida fora de ordem e intercalada com alterações de estado de outras chamadas a PFMultiplayerStartProcessingMatchmakingStateChanges(). É garantido que quaisquer recursos associados a uma alteração de estado específica permaneçam válidos até que a alteração de estado seja devolvida a PFMultiplayerFinishProcessingMatchmakingStateChanges().

## Requisitos

**Cabeçalho:** PFMatchmaking.h

## Confira também

[Membros do PFMatchmaking](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)\
[PFMatchmakingStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange)
[PFMultiplayerFinishProcessingMatchmakingStateChanges](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)


## Related topics

- [PFMultiplayerFinishProcessingMatchmakingStateChanges](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges.md)
- [PFMatchmakingStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange.md)
- [Guia de operações assíncronas do SDK C++ de Lobby e Matchmaking](/pt-BR/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Início rápido do SDK de Matchmaking](/pt-BR/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)