跳轉到主要內容
透過 PFMultiplayerServerListQosServersForTitleAsync 探索 QoS 信標,並透過 UDP/3075 對每個信標執行 Ping。彙總延遲並傳回排序後的清單。實際經過時間上限約為 ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion,再加上 ListQosServersForTitle 呼叫的耗時。

語法

參數

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 成員
最後修改於 2026年10月16日