> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerServerPingQosServersAsync

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

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

## 語法

```cpp theme={null}
HRESULT PFMultiplayerServerPingQosServersAsync(  
    PFEntityHandle entityHandle,  
    const PFMultiplayerServerPingQosServersOptions* options,  
    XAsyncBlock* async  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

已驗證的 PlayFab 實體。與 PFMultiplayerServerListQosServersForTitleAsync 所接受的控制代碼相同。

**`options`**   [PFMultiplayerServerPingQosServersOptions\*](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions)<br />*optional*

選擇性。NULL 表示套用 PFMultiplayerServerPingQosServersOptions 上記載的預設值。

**`async`**   XAsyncBlock\*<br />*Inout*

用於非同步作業的 XAsyncBlock。支援 XAsyncCancel。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於所有平台。所有區域皆逾時的網路 (例如，公司防火牆封鎖 UDP/3075) 不屬於失敗模式：作業會以 S\_OK 完成，且每個 PFMultiplayerServerQosResult 都會標示為無法連線，讓呼叫端能偵測並呈現該狀況。當非同步作業完成時，請呼叫 [PFMultiplayerServerPingQosServersGetResultSize](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) 和 [PFMultiplayerServerPingQosServersGetResult](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult) 以取得結果。

## 需求

**標頭：** PFMultiplayerServerQoS.h

## 另請參閱

[PFMultiplayerServerQoS 成員](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members)


## Related topics

- [PFMultiplayerServerPingQosServersOptions](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersGetResult](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)
- [PFMultiplayerServerPingQosServersResult](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResultSize](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize.md)
- [服務 C API 概觀 - PFMultiplayerServerQoS.h](/zh-TW/services/playfab/api-references/c/pfmultiplayerserverqos/pfmultiplayerserverqos_members.md)