> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConnectivityHintChangedCallback

> XNetworkingConnectivityHintChangedCallback

# XNetworkingConnectivityHintChangedCallback

Appelée lorsque la structure d'indication de connectivité est modifiée.

## Syntaxe

```cpp theme={null}
void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)
```

### Paramètres

*context*   \_In\_opt\_\
Type : void\*

Pointeur de contexte facultatif qui a été passé à la fonction [XNetworkingRegisterConnectivityHintChanged](/fr-CA/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged).

*connectivityHint*   \_In\_\
Type : [XNetworkingConnectivityHint](/fr-CA/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

Nouvelle structure d'indication de connectivité à l'échelle de l'appareil.

### Valeur de retour

Type : void

## Remarques

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 que quelque chose a changé depuis le dernier déclenchement du rappel.

<Note>La notion d'estimation au mieux s'applique à l'état actuel du réseau à l'échelle de l'appareil et au niveau de connectivité réseau. Il faut tenir compte du fait que l'initialisation du réseau n'est pas une estimation au mieux, car il peut arriver, rarement, que l'initialisation ne se produise pas.</Note>

Les champs de la structure `XNetworkingConnectivityHint` 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.

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 Series

## Voir aussi

[Récupération des informations réseau](/fr-CA/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingGetConnectivityHint](/fr-CA/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingRegisterConnectivityHintChanged](/fr-CA/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingUnregisterConnectivityHintChanged](/fr-CA/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/fr-CA/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)