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

# PartyManager::StartProcessingStateChanges

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

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

## Sintaxe

```cpp theme={null}
PartyError StartProcessingStateChanges(  
    uint32_t* stateChangeCount,  
    PartyStateChangeArray* stateChanges  
)  
```

### Parâmetros

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

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

**`stateChanges`**   [PartyStateChangeArray\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/typedefs.md)\
*matriz de saída alocada pela biblioteca de tamanho `*stateChangeCount`*

Uma matriz de saída alocada pela biblioteca de todas as entradas PartyStateChange que o título deve tratar e, em seguida, passar para [FinishProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md).

### Valor retornado

PartyError

`c_partyErrorSuccess` 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 [GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Comentários

Este método oferece à biblioteca do Party uma 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 seu próprio estado ou interface do usuário e, em seguida, chamar [FinishProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md) com elas em tempo hábil. \
\
 O estado da biblioteca do Party exposto pela biblioteca pode mudar durante esta chamada, portanto, seu uso dele precisa ser thread-safe. Por exemplo, invocar StartProcessingStateChanges() no seu thread de interface do usuário ao mesmo tempo em que um thread de trabalho separado está percorrendo a lista de pontos de extremidade retornada por [PartyNetwork::GetEndpoints()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_getendpoints.md) pode resultar em falhas, pois StartProcessingStateChanges() pode alterar a memória associada à lista de pontos de extremidade. StartProcessingStateChanges() 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 seu thread principal de interface do usuário com impacto insignificante. Para obter melhores resultados, você também deve minimizar o tempo gasto tratando as alterações de estado antes de chamar FinishProcessingStateChanges().   \
\
 Cada alteração de estado retornada por StartProcessingStateChanges() deve ser devolvida a FinishProcessingStateChanges() exatamente uma vez, mas pode ser devolvida fora de ordem e intercalada com alterações de estado de outras chamadas a StartProcessingStateChanges(). Há garantia de que todos os recursos associados a uma alteração de estado específica permaneçam válidos até que a alteração de estado seja devolvida a FinishProcessingStateChanges().

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[PartyManager](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager.md)\
[PartyStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partystatechange.md)\
[PartyManager::FinishProcessingStateChanges](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md)


## Related topics

- [PartyManager::FinishProcessingStateChanges](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md)
- [PartyStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partystatechange.md)
- [PartyManager::GetNetworks](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getnetworks.md)
- [PartyManager::GetChatControls](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getchatcontrols.md)
- [PartyManager::GetLocalUsers](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers.md)