Sintaxe
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().
Valor retornado
Tipo: HRESULTS_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().
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() com elas em tempo hábil.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().
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.hConfira também
Membros do PFMatchmakingPFMatchmakingStateChange PFMultiplayerFinishProcessingMatchmakingStateChanges