> ## 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 操作的选项。向 PFMultiplayerServerPingQosServersAsync 传递 NULL 可使用下文所述的默认值。

控制 QoS 区域 ping 操作的选项。向 PFMultiplayerServerPingQosServersAsync 传递 NULL 可使用下文所述的默认值。

## 语法

```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 区域的信标，而不仅仅是该 Title 已部署生成的区域。默认值为 false。

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

转发给 ListQosServersForTitle 的路由首选项，用于选择服务返回哪些信标 VIP。接受 MultiplayerServer RoutingType 枚举定义的字符串：“Microsoft”（默认值 — 其 Azure 公共 IP 标记为 Microsoft 网络层级路由的信标，路径尽可能多地经过 Azure 主干网）或“Internet”（端到端通过公共 Internet 路由的信标）。NULL 或空值表示不设置该字段，服务将应用其默认值（“Microsoft”）。如果某个 Title 发布了具有两种路由类型的数据平面 VIP，则应调用此 API 两次（每种首选项各一次），并根据玩家实际使用的数据平面对区域进行排名。

## 要求

**头文件：** PFMultiplayerServerQoS.h

## 另请参阅

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


## Related topics

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