XNetworkingConnectivityHintChangedCallback
Se llama cuando cambia la estructura de sugerencia de conectividad.Sintaxis
Parámetros
context _In_opt_Tipo: void* Un puntero de contexto opcional que se pasó a la función XNetworkingRegisterConnectivityHintChanged. connectivityHint _In_
Tipo: XNetworkingConnectivityHint* La nueva estructura de sugerencia de conectividad de todo el dispositivo.
Valor devuelto
Tipo: voidComentarios
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.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.
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 SeriesConsulte también
Recuperación de información de redXNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking