> ## 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

> 마지막 호출 이후 처리할 PlayFab Multiplayer 매치메이킹 상태 변경 배열을 검색하여, 타이틀이 티켓 및 매치 업데이트에 응답할 수 있게 합니다.

마지막 호출 이후 처리할 모든 매치메이킹 상태 변경 배열을 검색합니다.

## 구문

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

### 매개 변수

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 인스턴스의 핸들입니다.

**`stateChangeCount`**   uint32\_t\*\
*출력*

`stateChanges` 배열에서 타이틀이 처리해야 할 PFMatchmakingStateChange 항목의 출력 수입니다.

**`stateChanges`**   PFMatchmakingStateChange\* const\*\*\
*크기가 `*stateChangeCount`인 라이브러리에서 할당된 출력 배열*

타이틀이 처리하고 그런 다음 [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)에 전달할 모든 PFMatchmakingStateChange 항목의 라이브러리에서 할당된 출력 배열입니다.

### 반환 값

형식: HRESULT

호출에 성공한 경우 `S_OK`이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage)를 통해 검색할 수 있습니다.

## 설명

이 메서드는 매치메이킹 라이브러리에 원격 디바이스 또는 서비스와 상태를 동기화할 기회를 제공하며, 이 메서드에 대한 마지막 호출 이후 타이틀에 대해 현재 사용 가능한 모든 변경 목록을 검색합니다. 타이틀은 제공된 0개 이상의 변경 배열을 사용하여 자체 상태 또는 UI를 업데이트한 다음, 적시에 [PFMultiplayerFinishProcessingMatchmakingStateChanges()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges)를 호출해야 합니다. <br /><br /> 라이브러리에서 노출되는 매치메이킹 라이브러리 상태는 이 호출 중에 변경될 수 있으므로 이를 사용할 때 스레드로부터 안전해야 합니다. PFMultiplayerStartProcessingMatchmakingStateChanges()는 자주 호출해야 합니다-- 그래픽 프레임당 적어도 한 번씩입니다. 무시할 수 있는 영향으로 주 UI 스레드에서 호출할 수 있도록 신속하게 실행되고 반환되도록 설계되었습니다. 최상의 결과를 얻으려면 PFMultiplayerFinishProcessingMatchmakingStateChanges()를 호출하기 전에 상태 변경을 처리하는 데 소요되는 시간도 최소화해야 합니다.   <br /><br /> PFMultiplayerStartProcessingMatchmakingStateChanges()에서 반환된 각 상태 변경은 정확히 한 번만 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 반환되어야 하지만, 순서에 상관없이 반환될 수 있으며 PFMultiplayerStartProcessingMatchmakingStateChanges()에 대한 다른 호출의 상태 변경과 혼합될 수 있습니다. 특정 상태 변경과 관련된 리소스는 상태 변경이 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 반환될 때까지 유효한 상태로 유지되도록 보장됩니다.

## 요구 사항

**헤더:** PFMatchmaking.h

## 함께 보기

[PFMatchmaking members](/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](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerfinishprocessingmatchmakingstatechanges.md)
- [PFMatchmakingStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingstatechange.md)
- [비동기 Lobby 및 Matchmaking C++ SDK 작업 가이드](/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking-client-sdk-async.md)
- [Matchmaking SDK quickstart](/ko/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)