XNetworkingRegisterConnectivityHintChanged
Registra el título para recibir cambios en la 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
queue _In_opt_Tipo: XTaskQueueHandle Cola en la que se coloca la devolución de llamada cuando cambia la sugerencia de conectividad. context _In_opt_
Tipo: void* Puntero de contexto opcional que se pasa a la devolución de llamada. callback _In_
Tipo: XNetworkingConnectivityHintChangedCallback* Función a la que se llama cuando cambia la sugerencia de conectividad. token _Out_
Tipo: XTaskQueueRegistrationToken* Token que se usa para identificar la devolución de llamada al anular el registro.
Valor devuelto
Tipo: HRESULT Código HRESULT de éxito o de error.Comentarios
Esta función registra una notificación de “sugerencia de conectividad cambiada” y envía una devolución de llamada de notificación inicial. Para anular el registro de una devolución de llamada, use 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 en el dispositivo. Es importante destacar 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 a 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 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 de red y conectividad.
Este método consulta el estado local dentro del proceso que realiza la llamada y se 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
XNetworkingGetConnectivityHintXNetworkingUnregisterConnectivityHintChanged
XNetworking