Sintaxis
Parámetros
handle PFMultiplayerHandle
El identificador de la instancia de la API PFMultiplayer.
stateChangeCount uint32_t*salida El número de salida de entradas PFMatchmakingStateChange que el título debe controlar en la matriz
stateChanges.
stateChanges PFMatchmakingStateChange* const**matriz de salida asignada por la biblioteca de tamaño
*stateChangeCount
Una matriz de salida asignada por la biblioteca de todas las entradas PFMatchmakingStateChange que el título debe controlar y, después, pasar a PFMultiplayerFinishProcessingMatchmakingStateChanges().
Valor devuelto
Tipo: HRESULTS_OK 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 PFMultiplayerGetErrorMessage().
Comentarios
Este método proporciona a la biblioteca de emparejamiento la oportunidad de sincronizar el estado con dispositivos o servicios remotos, y recupera una lista de todos los cambios disponibles actualmente 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 interfaz de usuario y, después, llamar a PFMultiplayerFinishProcessingMatchmakingStateChanges() con ellos de manera oportuna.El estado de la biblioteca de emparejamiento expuesto por la biblioteca puede cambiar durante esta llamada, por lo que su uso debe ser seguro para subprocesos. Se debe llamar a PFMultiplayerStartProcessingMatchmakingStateChanges() con frecuencia, al menos una vez por fotograma gráfico. Está diseñado para ejecutarse y devolver resultados 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 PFMultiplayerFinishProcessingMatchmakingStateChanges().
Cada cambio de estado devuelto por PFMultiplayerStartProcessingMatchmakingStateChanges() debe devolverse a PFMultiplayerFinishProcessingMatchmakingStateChanges() exactamente una vez, pero puede devolverse fuera de orden y puede intercalarse con cambios de estado de otras llamadas a PFMultiplayerStartProcessingMatchmakingStateChanges(). Se garantiza que los recursos asociados a un cambio de estado específico siguen siendo válidos hasta que el cambio de estado se devuelve a PFMultiplayerFinishProcessingMatchmakingStateChanges().
Requisitos
Encabezado: PFMatchmaking.hConsulte también
Miembros de PFMatchmakingPFMatchmakingStateChange
PFMultiplayerFinishProcessingMatchmakingStateChanges