> ## 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

Se llama cuando cambia la estructura de sugerencia de conectividad.

## Sintaxis

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

### Parámetros

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

Un puntero de contexto opcional que se pasó a la función [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged).

*connectivityHint*   \_In\_\
Tipo: [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

La nueva estructura de sugerencia de conectividad de todo el dispositivo.

### Valor devuelto

Tipo: void

## Comentarios

Se llama a esta función de devolución de llamada cuando cambia algo relacionado con la conectividad actual del dispositivo. Incluye el puntero de contexto que se pasó cuando se llamó a la función de registro. El desencadenamiento de esta devolución de llamada no garantiza que algo haya cambiado desde la última vez que se desencadenó la devolución de llamada.

<Note>El concepto de mejor esfuerzo se refiere al estado actual de la red y al nivel de conectividad de red de todo el dispositivo. Debe tenerse en cuenta que la inicialización de la red no es de mejor esfuerzo, porque en ocasiones poco frecuentes la inicialización puede no producirse.</Note>

Los campos de la estructura `XNetworkingConnectivityHint` devuelta (excepto el campo `XNetworkingConnectivityHint::networkInitialized`) son sugerencias. Son estimaciones de mejor esfuerzo realizadas por el dispositivo sobre el estado actual de la red, basadas en un resumen del tráfico de red del dispositivo. Es importante señalar que estos campos no representan si hay conectividad con los puntos de conexión específicos de su título. Se recomienda que, después de esperar la inicialización de la red, use WinSock o WinHTTP para intentar establecer una conexión con su punto de conexión, independientemente del estado del campo `XNetworkingConnectivityHint::connectivityLevelHint`. Si esas API fallan posteriormente, se recomienda usar entonces la API `XNetworkingGetConnectivityHint` con fines adicionales de interfaz de usuario e informes de diagnóstico. Después, debe esperar a que se produzca un cambio en el nivel de conectividad de red antes de volver a intentarlo.

Este método consulta el estado local dentro del proceso que realiza la llamada y devuelve rápidamente, por lo que es seguro llamarlo desde contextos con restricciones de tiempo.

## Requisitos

**Encabezado:** XNetworking.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Recuperación de información de red](/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)