XNetworkingGetConnectivityHint
Consulta información de todo el dispositivo sobre el nivel actual de conectividad de red, los límites de datos, el tipo de interfaz y el estado de inicialización de la red.Sintaxis
Parámetros
connectivityHint _Out_Tipo: XNetworkingConnectivityHint* El estado actual de la red en todo el dispositivo.
Valor devuelto
Tipo: HRESULT Código HRESULT de éxito o de error.Comentarios
Esta función devuelve información de todo el dispositivo sobre el nivel de conectividad de red, los límites de datos, la conectividad por cable frente a inalámbrica y si la red está inicializada. Puede escuchar los cambios con las funciones XNetworkingRegisterConnectivityHintChanged y XNetworkingUnregisterConnectivityHintChanged. Los campos de la estructuraXNetworkingConnectivityHint 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.
Para obtener más información sobre la inicialización de la red, consulte Inicialización y conectividad de red.
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 SeriesConsulte también
XNetworkingRegisterConnectivityHintChangedXNetworkingUnregisterConnectivityHintChanged
Detección del estado de inicialización de la red
XNetworking