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

# PFMultiplayerStartProcessingLobbyStateChanges

> Recupera a matriz de entradas PFLobbyStateChange de um lobby do PlayFab Multiplayer a serem processadas desde a última chamada, permitindo que o título atualize o estado ou a interface do usuário.

Recupera uma matriz de todas as PFLobbyStateChanges a serem processadas desde a última chamada desse tipo.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerStartProcessingLobbyStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t* stateChangeCount,  
    const PFLobbyStateChange* 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 PFLobbyStateChange que o título deve tratar na matriz `stateChanges`.

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

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

### 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 do Lobby 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 [PFMultiplayerFinishProcessingLobbyStateChanges()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfinishprocessinglobbystatechanges) com elas em tempo hábil. <br /><br /> O estado da biblioteca do Lobby exposto pela biblioteca pode mudar durante esta chamada, portanto você precisa usá-lo de forma thread-safe. Por exemplo, invocar PFMultiplayerStartProcessingLobbyStateChanges() no thread da interface do usuário ao mesmo tempo em que um thread de trabalho separado percorre a lista de membros do lobby retornada por [PFLobbyGetMembers()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers) pode resultar em falhas, pois PFMultiplayerStartProcessingLobbyStateChanges() pode alterar a memória associada à lista de membros. PFMultiplayerStartProcessingLobbyStateChanges() 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 PFMultiplayerFinishProcessingLobbyStateChanges().   <br /><br /> Cada alteração de estado retornada por PFMultiplayerStartProcessingLobbyStateChanges() precisa ser devolvida a PFMultiplayerFinishProcessingLobbyStateChanges() exatamente uma vez, mas pode ser devolvida fora de ordem e intercalada com alterações de estado de outras chamadas a PFMultiplayerStartProcessingLobbyStateChanges(). É 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 PFMultiplayerFinishProcessingLobbyStateChanges().

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)\
[PFLobbyStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbystatechange)
[PFMultiplayerFinishProcessingLobbyStateChanges](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfinishprocessinglobbystatechanges)


## Related topics

- [PFMultiplayerFinishProcessingLobbyStateChanges](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfinishprocessinglobbystatechanges.md)
- [PFLobbyStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbystatechange.md)
- [PFLobbyUpdatedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md)
- [PFLobbyGetLobbyId](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyid.md)
- [PFLobbyGetOwner](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetowner.md)