PFMultiplayerServerPingQosServersAsync - XBOX Game Development Documentation

PFMultiplayerServerListQosServersForTitleAsync를 통해 QoS 비콘을 검색하고 UDP/3075를 통해 각 비콘에 ping을 보냅니다. 대기 시간을 집계하여 정렬된 목록을 반환합니다. 실제 경과 시간은 대략 ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion에 ListQosServersForTitle 호출 비용을 더한 값으로 제한됩니다.

Syntax

HRESULT PFMultiplayerServerPingQosServersAsync(  
    PFEntityHandle entityHandle,  
    const PFMultiplayerServerPingQosServersOptions* options,  
    XAsyncBlock* async  
)  

Parameters

entityHandle PFEntityHandle 인증된 PlayFab 엔터티입니다. PFMultiplayerServerListQosServersForTitleAsync에서 허용하는 것과 동일한 핸들입니다. options PFMultiplayerServerPingQosServersOptions*
optional 선택 사항입니다. NULL이면 PFMultiplayerServerPingQosServersOptions에 설명된 기본값이 적용됩니다. async XAsyncBlock*
Inout 비동기 작업을 위한 XAsyncBlock입니다. XAsyncCancel을 지원합니다.

Return value

Type: HRESULT 이 API 작업의 결과 코드입니다.

Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 모든 지역이 시간 초과되는 네트워크(예: 회사 방화벽이 UDP/3075를 차단하는 경우)는 실패 모드가 아닙니다. 작업은 S_OK로 완료되며 모든 PFMultiplayerServerQosResult가 연결할 수 없음으로 표시되므로 호출자가 해당 상태를 감지하고 표시할 수 있습니다. 비동기 작업이 완료되면 PFMultiplayerServerPingQosServersGetResultSize 및 PFMultiplayerServerPingQosServersGetResult를 호출하여 결과를 가져옵니다.

Requirements

Header: PFMultiplayerServerQoS.h

See also

PFMultiplayerServerQoS members

마지막 수정일 2026년 10월 16일

⌘I