구문
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
stateChangeCount uint32_t*출력
stateChanges 배열에서 타이틀이 처리해야 할 PFMatchmakingStateChange 항목의 출력 수입니다.
stateChanges PFMatchmakingStateChange* const**크기가
*stateChangeCount인 라이브러리에서 할당된 출력 배열
타이틀이 처리하고 그런 다음 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 전달할 모든 PFMatchmakingStateChange 항목의 라이브러리에서 할당된 출력 배열입니다.
반환 값
형식: HRESULT 호출에 성공한 경우S_OK이며 그렇지 않은 경우 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 메서드는 매치메이킹 라이브러리에 원격 디바이스 또는 서비스와 상태를 동기화할 기회를 제공하며, 이 메서드에 대한 마지막 호출 이후 타이틀에 대해 현재 사용 가능한 모든 변경 목록을 검색합니다. 타이틀은 제공된 0개 이상의 변경 배열을 사용하여 자체 상태 또는 UI를 업데이트한 다음, 적시에 PFMultiplayerFinishProcessingMatchmakingStateChanges()를 호출해야 합니다.라이브러리에서 노출되는 매치메이킹 라이브러리 상태는 이 호출 중에 변경될 수 있으므로 이를 사용할 때 스레드로부터 안전해야 합니다. PFMultiplayerStartProcessingMatchmakingStateChanges()는 자주 호출해야 합니다— 그래픽 프레임당 적어도 한 번씩입니다. 무시할 수 있는 영향으로 주 UI 스레드에서 호출할 수 있도록 신속하게 실행되고 반환되도록 설계되었습니다. 최상의 결과를 얻으려면 PFMultiplayerFinishProcessingMatchmakingStateChanges()를 호출하기 전에 상태 변경을 처리하는 데 소요되는 시간도 최소화해야 합니다.
PFMultiplayerStartProcessingMatchmakingStateChanges()에서 반환된 각 상태 변경은 정확히 한 번만 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 반환되어야 하지만, 순서에 상관없이 반환될 수 있으며 PFMultiplayerStartProcessingMatchmakingStateChanges()에 대한 다른 호출의 상태 변경과 혼합될 수 있습니다. 특정 상태 변경과 관련된 리소스는 상태 변경이 PFMultiplayerFinishProcessingMatchmakingStateChanges()에 반환될 때까지 유효한 상태로 유지되도록 보장됩니다.
요구 사항
헤더: PFMatchmaking.h함께 보기
PFMatchmaking membersPFMatchmakingStateChange
PFMultiplayerFinishProcessingMatchmakingStateChanges