Pular para o conteúdo principal
Recupera uma matriz de todas as alterações de estado do Party XBOX Live a serem processadas desde a última chamada desse tipo.

Sintaxe

Parâmetros

stateChangeCount   uint32_t*
saída
Um local para gravar o número de entradas PartyXblStateChange que o título deve tratar na matriz stateChanges. stateChanges   PartyXblStateChangeArray*
matriz de saída alocada pela biblioteca de tamanho *stateChangeCount
Um local para armazenar um ponteiro para a matriz de todas as entradas PartyXblStateChange que o título deve tratar e, em seguida, passar para FinishProcessingStateChanges().

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().

Comentários

Este método dá à biblioteca Party XBOX Live Helper a oportunidade de recuperar 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, com 0 ou mais alterações, para atualizar seu próprio estado ou interface do usuário e, em seguida, chamar FinishProcessingStateChanges() com elas em tempo hábil.

O estado exposto pela biblioteca pode mudar durante esta chamada, portanto, seu uso dele deve ser thread-safe. StartProcessingStateChanges() deve ser chamado com frequência, pelo menos uma vez a cada 100 milissegundos. 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, minimize também 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(). Todos os recursos associados a uma alteração de estado específica têm a garantia de permanecer válidos até que a alteração de estado seja devolvida a FinishProcessingStateChanges().

Requisitos

Cabeçalho: PartyXboxLive.h

Confira também

PartyXblManager
PartyXblStateChange
PartyXblManager::FinishProcessingStateChanges
Última modificação em 8 de outubro de 2026