XNetworkingRegisterConnectivityHintChanged
Inscrit le titre aux changements des informations à l’échelle de l’appareil sur le niveau actuel de connectivité réseau, les limites de données, le type d’interface et l’état d’initialisation du réseau.Syntaxe
Paramètres
queue _In_opt_Type : XTaskQueueHandle File d’attente dans laquelle placer le rappel lorsque l’indication de connectivité change. context _In_opt_
Type : void* Pointeur de contexte facultatif à passer au rappel. callback _In_
Type : XNetworkingConnectivityHintChangedCallback* Fonction à appeler lorsque l’indication de connectivité change. token _Out_
Type : XTaskQueueRegistrationToken* Jeton utilisé pour identifier le rappel lors de l’annulation de l’inscription.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
Cette fonction inscrit une notification de « changement de l’indication de connectivité » et envoie un rappel de notification initial. Pour annuler l’inscription d’un rappel, utilisez XNetworkingUnregisterConnectivityHintChanged. Les champs de la structureXNetworkingConnectivityHint retournée (à l’exception du champ XNetworkingConnectivityHint::networkInitialized) sont des indications. Il s’agit d’estimations au mieux faites par l’appareil quant à l’état actuel du réseau, en fonction d’un résumé du trafic réseau sur l’appareil. Fait important, ces champs n’indiquent pas s’il existe une connectivité vers les points de terminaison propres à 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 par la suite, nous vous recommandons d’utiliser l’API XNetworkingGetConnectivityHint à des fins d’interface utilisateur et de rapports de diagnostic supplémentaires. 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é du 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é dans 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
XNetworkingGetConnectivityHintXNetworkingUnregisterConnectivityHintChanged
XNetworking