XNetworkingGetConnectivityHint
Interroge les informations à l’échelle de l’appareil sur le niveau de connectivité réseau actuel, les limites de données, le type d’interface et l’état d’initialisation du réseau.Syntaxe
Paramètres
connectivityHint _Out_Type : XNetworkingConnectivityHint* État actuel du réseau à l’échelle de l’appareil.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
Cette fonction renvoie des informations à l’échelle de l’appareil sur le niveau de connectivité réseau, les limites de données, la connectivité filaire ou sans fil, et indique si le réseau est initialisé. Vous pouvez être à l’écoute des changements à l’aide des fonctions XNetworkingRegisterConnectivityHintChanged et XNetworkingUnregisterConnectivityHintChanged. Les champs de la structureXNetworkingConnectivityHint renvoyée (à l’exception du champ XNetworkingConnectivityHint::networkInitialized) sont des indications. Il s’agit d’estimations au mieux effectuées par l’appareil sur l’état actuel du réseau, basées sur un résumé du trafic réseau de l’appareil. Il est important de noter que ces champs n’indiquent pas s’il existe une connectivité vers les points de terminaison spécifiques de votre titre. Nous vous recommandons, après avoir attendu l’initialisation du réseau, d’utiliser WinSock et/ou WinHTTP pour tenter d’établir une connexion à votre point de terminaison, quel que soit l’état du champ XNetworkingConnectivityHint::connectivityLevelHint. Si ces API échouent ensuite, nous vous recommandons d’utiliser l’API XNetworkingGetConnectivityHint à des fins supplémentaires d’interface utilisateur et de rapports de diagnostic. Vous devez ensuite attendre un changement du niveau de connectivité réseau avant de réessayer.
Pour plus d’informations sur l’initialisation du réseau, consultez Initialisation et connectivité réseau.
Cette méthode interroge l’état local au sein du processus appelant et retourne rapidement ; elle peut donc être appelée en toute sécurité depuis des contextes où le temps est critique.
Configuration requise
En-tête : XNetworking.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
XNetworkingRegisterConnectivityHintChangedXNetworkingUnregisterConnectivityHintChanged
Détection de l’état d’initialisation du réseau
XNetworking