XNetworkingConnectivityHintChangedCallback
Appelée lorsque la structure d’indication de connectivité est modifiée.Syntaxe
Paramètres
context _In_opt_Type : void* Pointeur de contexte facultatif qui a été passé à la fonction XNetworkingRegisterConnectivityHintChanged. connectivityHint _In_
Type : XNetworkingConnectivityHint* Nouvelle structure d’indication de connectivité à l’échelle de l’appareil.
Valeur de retour
Type : voidRemarques
Cette fonction de rappel est appelée lorsqu’un élément de la connectivité actuelle de l’appareil change. Elle inclut le pointeur de contexte passé lors de l’appel de la fonction d’inscription. Le déclenchement de ce rappel ne garantit pas qu’un élément a changé depuis le dernier déclenchement du rappel.Le principe du « au mieux » s’applique à l’état actuel du réseau à l’échelle de l’appareil et au niveau de connectivité réseau. L’initialisation du réseau doit être respectée, car elle ne relève pas du « au mieux » : il peut arriver, rarement, que l’initialisation n’ait pas lieu.
XNetworkingConnectivityHint 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.
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
Récupération des informations réseauXNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking