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

# PFMultiplayerStartProcessingMatchmakingStateChanges

> Recupera la matriz de cambios de estado de emparejamiento de PlayFab Multiplayer que se deben procesar desde la última llamada, lo que permite al título responder a las actualizaciones de vales y coincidencias.

Recupera una matriz de todos los cambios de estado de emparejamiento que se deben procesar desde la última llamada de este tipo.

## Sintaxis

```cpp theme={null}
HRESULT PFMultiplayerStartProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t* stateChangeCount,  
    const PFMatchmakingStateChange* const** stateChanges  
)  
```

### 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()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges).

### Valor devuelto

Tipo: HRESULT

`S_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()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/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()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges) con ellos de manera oportuna. <br /><br /> 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().   <br /><br /> 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.h

## Consulte también

[Miembros de PFMatchmaking](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)\
[PFMatchmakingStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange)\
[PFMultiplayerFinishProcessingMatchmakingStateChanges](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)


## Related topics

- [PFMultiplayerFinishProcessingMatchmakingStateChanges](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges.md)
- [PFMatchmakingStateChange](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange.md)
- [Guía de operaciones asincrónicas del SDK de C++ de Lobby y Matchmaking](/es/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Inicio rápido del SDK de Matchmaking](/es/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)