Passer au contenu principal
Découvre les balises QoS au moyen de PFMultiplayerServerListQosServersForTitleAsync et envoie un ping à chacune d’elles par UDP/3075. Regroupe les latences et retourne 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 dans PFMultiplayerServerPingQosServersOptions s’appliquent. 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 dans lequel toutes les régions expirent (par exemple, un pare-feu d’entreprise qui bloque UDP/3075) n’est pas considéré comme un mode d’échec : l’opération se termine avec S_OK et chaque PFMultiplayerServerQosResult est marqué comme inaccessible, ce qui permet aux appelants de détecter et de 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