다음을 통해 공유

PFMultiplayerFinishProcessingMatchmakingStateChanges

  • 아티클

처리 중인 매치 메이킹 상태 변경의 배열을 반환합니다.

구문

HRESULT PFMultiplayerFinishProcessingMatchmakingStateChanges(  
    PFMultiplayerHandle handle,  
    uint32_t stateChangeCount,  
    const PFMatchmakingStateChange* const* stateChanges  
)

매개 변수

handle PFMultiplayerHandle

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

stateChangeCount uint32_t

이전에 PFMultiplayerStartProcessingMatchmakingStateChanges()에 의해 반환되었으며 현재 타이틀에 의해 처리된 변경 내용의 수는 stateChanges에 의해 지정된 목록에 제공됩니다.

stateChanges PFMatchmakingStateChange* const*
크기가 stateChangeCount인 입력 배열

이전에 PFMultiplayerStartProcessingMatchmakingStateChanges()에 의해 반환되었으며 이제 타이틀에서 처리된 변경 내용의 배열입니다.

반환 값

형식: HRESULT

호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.

설명

이 메서드는 PFMultiplayerStartProcessingMatchmakingStateChanges()에 대한 이전 호출에서 보고된 상태 변경이 이제 타이틀에서 처리되었으므로 연결된 리소스를 회수할 수 있음을 매치 메이킹 라이브러리에 알립니다. 상태 변경 횟수에 관계없이 PFMultiplayerFinishProcessingMatchmakingStateChanges()를 호출할 수 있습니다. PFMultiplayerStartProcessingMatchmakingStateChanges()에 의해 반환된 각 상태 변경은 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 정확히 한 번 반환되어야 하지만 순서가 맞지 않게 반환될 수 있으며 PFMultiplayerStartProcessingMatchmakingStateChanges()에 대한 다른 호출의 상태 변경과 인터리브될 수 있습니다.

특정 상태 변경과 관련된 모든 리소스는 상태 변경이 PFMultiplayerFinishProcessingMatchmakingStateChanges()로 반환될 때까지 유효하게 유지됩니다.

최상의 결과를 얻으려면 PFMultiplayerFinishProcessingMatchmakingStateChanges()를 호출하기 전에 상태 변경을 처리하는 데 소요되는 시간을 최소화해야 합니다.

요구 사항

헤더: PFMatchmaking.h

참고 항목

PFMatchmaking 멤버
PFMatchmakingStateChange
PFMultiplayerStartProcessingMatchmakingStateChanges