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

# 服务 C API 概览 - PFMultiplayerServerQoS.h

> 服务 C API 概览 - PFMultiplayerServerQoS.h

## 函数

| 函数 | 说明 |
| - | - |
| [PFMultiplayerServerPingQosServersAsync](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversasync) | 通过 PFMultiplayerServerListQosServersForTitleAsync 发现 QoS 信标，并通过 UDP/3075 逐一对其执行 ping 操作。汇总延迟并返回排序后的列表。实际耗时上限大约为 ceil(regionCount / maxConcurrentRegions) \* timeoutMs \* pingsPerRegion，再加上 ListQosServersForTitle 调用的耗时。 |
| [PFMultiplayerServerPingQosServersGetResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult) | 获取成功的 PFMultiplayerServerPingQosServersAsync 调用的结果。 |
| [PFMultiplayerServerPingQosServersGetResultSize](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresultsize) | 获取存储 PFMultiplayerServerPingQosServersAsync 调用结果所需的字节大小。 |

## 结构

| 结构 | 说明 |
| - | - |
| [PFMultiplayerServerPingQosServersOptions](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions) | 控制 QoS 区域 ping 操作的选项。向 PFMultiplayerServerPingQosServersAsync 传递 NULL 可使用下文所述的默认值。 |
| [PFMultiplayerServerPingQosServersResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult) | PFMultiplayerServerPingQosServersAsync 的汇总结果。区域按 latencyMs 升序排列；无法访问的区域 (latencyMs == UINT32\_MAX) 排在末尾。 |
| [PFMultiplayerServerQosResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverqosresult) | 每个区域的结果行。指针指向调用方提供的结果缓冲区内部，仅当该缓冲区保持有效且未被移动时才有效。 |


## Related topics

- [服务 C API 概览 - PFMultiplayerServer.h](/zh-CN/services/playfab/api-references/c/pfmultiplayerserver/pfmultiplayerserver_members.md)
- [服务 C API 概览 - PFMultiplayerServerTypes.h](/zh-CN/services/playfab/api-references/c/pfmultiplayerservertypes/pfmultiplayerservertypes_members.md)
- [PFMultiplayerServerQosResult](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverqosresult.md)
- [PFMultiplayerServerPingQosServersOptions](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersAsync](/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversasync.md)