> ## 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.

# PFMultiplayerServerPingQosServersOptions

> 控制 QoS 區域 Ping 作業的選項。將 NULL 傳遞給 PFMultiplayerServerPingQosServersAsync 以使用下方記載的預設值。

控制 QoS 區域 Ping 作業的選項。將 NULL 傳遞給 PFMultiplayerServerPingQosServersAsync 以使用下方記載的預設值。

## 語法

```cpp theme={null}
typedef struct PFMultiplayerServerPingQosServersOptions {  
    uint32_t timeoutMs;  
    uint32_t pingsPerRegion;  
    uint32_t maxConcurrentRegions;  
    bool includeAllRegions;  
    const char* routingPreference;  
} PFMultiplayerServerPingQosServersOptions;  
```

### 成員

**`timeoutMs`**   uint32\_t

每次 Ping 的接收逾時 (以毫秒為單位)。未在此時間範圍內收到有效回應的 Ping 會計為失敗。預設值為 250。

**`pingsPerRegion`**   uint32\_t

每個區域的 Ping 反覆次數。回報的 latencyMs 是成功反覆項目的算術平均值。預設值為 3。

**`maxConcurrentRegions`**   uint32\_t

同時探查的區域數目上限。每個區域在探查進行期間會開啟一個 UDP 通訊端。預設值為 0，解譯為「同時探查所有區域」。

**`includeAllRegions`**   bool

若為 true，則會要求 ListQosServersForTitle 傳回每個 Azure 區域的信標，而不只是遊戲已部署組建的區域。預設值為 false。

**`routingPreference`**   const char\*\
*is null-terminated*

轉送至 ListQosServersForTitle 的路由喜好設定，用於選取服務要傳回的信標 VIP。接受 MultiplayerServer RoutingType 列舉所定義的字串："Microsoft" (預設值 — 其 Azure 公用 IP 標記為 Microsoft 網路層路由的信標，會盡可能在路徑的大部分經由 Azure 骨幹傳輸) 或 "Internet" (端對端透過公用網際網路路由的信標)。NULL 或空白會讓此欄位保持未設定，並由服務套用其預設值 ("Microsoft")。同時提供這兩種路由類型之資料平面 VIP 的遊戲，應呼叫此 API 兩次 (每種喜好設定各一次)，並依據玩家實際使用的資料平面為區域排名。

## 需求

**標頭：** PFMultiplayerServerQoS.h

## 另請參閱

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


## Related topics

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