XblMultiplayerManagerFindMatch
서버에 매치메이킹 요청을 제출합니다.Syntax
Parameters
hopperName _In_z_Type: char* 이 요청의 호퍼 이름입니다. attributesJson _In_opt_z_
Type: char* 선택 사항입니다. JSON 문자열로 지정된 이 요청의 매치 티켓 속성입니다. timeoutInSeconds _In_
Type: uint32_t 사용자가 매치에 참여할 때까지 기다리는 최대 시간(초)입니다.
Return value
Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.Remarks
이 함수는 로비 세션의 매치메이킹 요청을 Multiplayer Manager(MPM)에 제출합니다. 이 함수를 사용하기 전에 먼저 타이틀의 서비스 구성에서 호퍼를 구성해야 합니다. 호퍼는 SmartMatch가 플레이어를 매치하는 데 사용하는 규칙을 정의합니다. 호퍼에 대한 자세한 내용은 매치메이킹 개요를 참조하세요. XblMultiplayerManagerInitialize가 호출되지 않았기 때문에 로비 세션이 없거나, 이 함수를 호출하기 전에 로컬 사용자가 로비 세션에 추가되지 않은 경우 오류가 발생합니다. 매치메이킹이 이미 진행 중인 경우에도 오류가 발생합니다.이 함수의 결과는 이벤트 형식이
XblMultiplayerEventType::FindMatchCompleted로 설정된 멀티플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.
Requirements
Header: multiplayer_manager_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.libSee also
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime