Passer au contenu principal
Options qui contrôlent une opération de ping des régions QoS. Passez NULL à PFMultiplayerServerPingQosServersAsync pour utiliser les valeurs par défaut documentées ci-dessous.

Syntaxe

Membres

timeoutMs uint32_t Délai d’expiration de réception par ping, en millisecondes. Un ping qui ne reçoit pas d’écho valide dans ce délai est compté comme un échec. Valeur par défaut : 250. pingsPerRegion uint32_t Nombre d’itérations de ping par région. La valeur latencyMs signalée est la moyenne arithmétique des itérations réussies. Valeur par défaut : 3. maxConcurrentRegions uint32_t Nombre maximal de régions sondées simultanément. Un socket UDP est ouvert par région pendant que son sondage est en cours. Valeur par défaut : 0, interprétée comme « toutes les régions simultanément ». includeAllRegions bool Si la valeur est true, ListQosServersForTitle est invité à retourner les balises de chaque région Azure plutôt que seulement celles des régions où le titre a déployé des builds. Valeur par défaut : false. routingPreference const char*
is null-terminated
Préférence de routage transmise à ListQosServersForTitle, qui détermine les adresses VIP de balise retournées par le service. Accepte les chaînes définies par l’énumération RoutingType de MultiplayerServer : « Microsoft » (valeur par défaut — balises dont les adresses IP publiques Azure sont marquées pour le routage de niveau réseau Microsoft, qui empruntent la dorsale Azure sur la plus grande partie possible du trajet) ou « Internet » (balises routées de bout en bout sur l’Internet public). Une valeur NULL ou vide laisse le champ non défini, et le service applique sa valeur par défaut (« Microsoft »). Un titre qui fournit des adresses VIP de plan de données avec les deux types de routage devrait appeler cette API deux fois (une fois par préférence) et classer les régions selon le plan de données que le joueur utilisera réellement.

Configuration requise

En-tête : PFMultiplayerServerQoS.h

Voir aussi

Membres de PFMultiplayerServerQoS
Dernière modification le 16 octobre 2026