PFMultiplayerServerPingQosServersAsync

通过 PFMultiplayerServerListQosServersForTitleAsync 发现 QoS 信标，并通过 UDP/3075 逐一对其执行 ping 操作。汇总延迟并返回排序后的列表。实际耗时上限大约为 ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion，再加上 ListQosServersForTitle 调用的耗时。

语法

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

参数

entityHandle PFEntityHandle 经过身份验证的 PlayFab 实体。与 PFMultiplayerServerListQosServersForTitleAsync 接受的句柄相同。 options PFMultiplayerServerPingQosServersOptions*
optional 可选。NULL 表示应用 PFMultiplayerServerPingQosServersOptions 中所述的默认值。 async XAsyncBlock*
Inout 用于异步操作的 XAsyncBlock。支持 XAsyncCancel。

返回值

类型：HRESULT 此 API 操作的结果代码。

备注

此 API 在所有平台上都可用。所有区域均超时的网络（例如，企业防火墙阻止了 UDP/3075）不属于故障模式：操作会以 S_OK 完成，并且每个 PFMultiplayerServerQosResult 都会被标记为无法访问，以便调用方检测并报告这种情况。异步操作完成后，调用 PFMultiplayerServerPingQosServersGetResultSize 和 PFMultiplayerServerPingQosServersGetResult 以获取结果。

要求

头文件： PFMultiplayerServerQoS.h

另请参阅

PFMultiplayerServerQoS 成员

PlayFab API

PlayFab REST API References

语法

参数

返回值

备注

要求

另请参阅

​语法

​参数

​返回值

​备注

​要求

​另请参阅

语法

参数

返回值

备注

要求

另请参阅