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

# Services C API 概览 - PFMultiplayerServerQoS.h

> PFMultiplayerServerQoS.h 中的函数和结构索引，用于在 C API 中对 PlayFab QoS 服务器执行 ping 操作并读取各区域的延迟结果。

## 函数

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

## 结构

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


## Related topics

- [PFMultiplayerServerQosResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverqosresult.md)
- [PFMultiplayerServerPingQosServersAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversasync.md)
- [PFMultiplayerServerPingQosServersOptions](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversoptions.md)
- [PFMultiplayerServerPingQosServersResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/structs/pfmultiplayerserverpingqosserversresult.md)
- [PFMultiplayerServerPingQosServersGetResult](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfmultiplayerserverqos/functions/pfmultiplayerserverpingqosserversgetresult.md)