Sintaxis
Parámetros
stateChangeCount uint32_t*salida El número de salida de entradas de PartyStateChange que el título debe controlar en la matriz
stateChanges.
stateChanges PartyStateChangeArray*matriz de salida asignada por la biblioteca de tamaño
*stateChangeCount
Una matriz de salida asignada por la biblioteca de todas las entradas de PartyStateChange que el título debe controlar y luego pasar a FinishProcessingStateChanges().
Valor devuelto
PartyErrorc_partyErrorSuccess si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante GetErrorMessage().
Comentarios
Este método ofrece a la biblioteca de Party la oportunidad de sincronizar el estado con dispositivos o servicios remotos, y recupera una lista de todos los cambios actualmente disponibles para el título desde la última llamada a este método. El título debe usar la matriz proporcionada de 0 o más cambios para actualizar su propio estado o su interfaz de usuario y, a continuación, llamar a FinishProcessingStateChanges() con ellos de manera oportuna.El estado de la biblioteca de Party expuesto por la biblioteca puede cambiar durante esta llamada, por lo que debe garantizar la seguridad de los subprocesos al usarlo. Por ejemplo, invocar StartProcessingStateChanges() en el subproceso de la interfaz de usuario al mismo tiempo que otro subproceso de trabajo independiente recorre en bucle la lista de puntos de conexión devuelta por PartyNetwork::GetEndpoints() puede provocar bloqueos, porque StartProcessingStateChanges() puede modificar la memoria asociada a la lista de puntos de conexión. StartProcessingStateChanges() se debe llamar con frecuencia: al menos una vez por fotograma de gráficos. Está diseñado para ejecutarse y devolver el control rápidamente, de modo que se pueda llamar en el subproceso principal de la interfaz de usuario con un impacto insignificante. Para obtener los mejores resultados, también debe minimizar el tiempo que dedica a controlar los cambios de estado antes de llamar a FinishProcessingStateChanges().
Cada cambio de estado devuelto por StartProcessingStateChanges() debe devolverse a FinishProcessingStateChanges() exactamente una vez, pero puede devolverse desordenado y puede intercalarse con cambios de estado de otras llamadas a StartProcessingStateChanges(). Se garantiza que los recursos asociados a un cambio de estado específico permanecen válidos hasta que el cambio de estado se devuelve a FinishProcessingStateChanges().
Requisitos
Encabezado: Party.hConsulte también
PartyManagerPartyStateChange
PartyManager::FinishProcessingStateChanges