Passer au contenu principal
Découvre les balises QoS via PFMultiplayerServerListQosServersForTitleAsync et envoie un ping à chacune d’elles via UDP/3075. Agrège les latences et renvoie la liste triée. La durée réelle écoulée est limitée à environ ceil(regionCount / maxConcurrentRegions) * timeoutMs * pingsPerRegion, plus le coût de l’appel ListQosServersForTitle.

​
Syntaxe

​
Paramètres

entityHandle PFEntityHandle Entité PlayFab authentifiée. Il s’agit du même handle que celui accepté par PFMultiplayerServerListQosServersForTitleAsync. options PFMultiplayerServerPingQosServersOptions*
optional Facultatif. NULL signifie que les valeurs par défaut documentées pour PFMultiplayerServerPingQosServersOptions sont appliquées. async XAsyncBlock*
Inout XAsyncBlock pour l’opération asynchrone. Prend en charge XAsyncCancel.

​
Valeur de retour

Type : HRESULT Code de résultat de cette opération d’API.

​
Notes

Cette API est disponible sur toutes les plateformes. Un réseau sur lequel toutes les régions expirent (par exemple, un pare-feu d’entreprise bloquant UDP/3075) ne constitue pas un mode d’échec : l’opération se termine avec S_OK et chaque PFMultiplayerServerQosResult est marqué comme inaccessible, afin que les appelants puissent détecter et signaler cette situation. Une fois l’opération asynchrone terminée, appelez PFMultiplayerServerPingQosServersGetResultSize et PFMultiplayerServerPingQosServersGetResult pour obtenir le résultat.

​
Configuration requise

En-tête : PFMultiplayerServerQoS.h

​
Voir aussi

Membres de PFMultiplayerServerQoS
Dernière modification le 16 octobre 2026