XNetworkingConnectivityHintChangedCallback
É chamado quando a estrutura de dica de conectividade é alterada.Sintaxe
Parâmetros
context _In_opt_Tipo: void* Um ponteiro de contexto opcional que foi passado para a função XNetworkingRegisterConnectivityHintChanged. connectivityHint _In_
Tipo: XNetworkingConnectivityHint* A nova estrutura de dica de conectividade de todo o dispositivo.
Valor retornado
Tipo: voidComentários
Essa função de retorno de chamada é chamada quando algo na conectividade atual do dispositivo é alterado. Ela inclui o ponteiro de contexto passado quando a função de registro foi chamada. O disparo desse retorno de chamada não garante que algo tenha mudado desde a última vez que o retorno de chamada foi disparado.O melhor esforço refere-se ao estado atual da rede em todo o dispositivo e ao nível de conectividade de rede. Deve-se considerar que a inicialização da rede não é de melhor esforço, pois, ocasionalmente, a inicialização pode não acontecer.
XNetworkingConnectivityHint retornada (exceto o campo XNetworkingConnectivityHint::networkInitialized) são dicas. Eles são estimativas de melhor esforço feitas pelo dispositivo sobre o estado atual da rede, com base em um resumo do tráfego de rede no dispositivo. É importante ressaltar que esses campos não representam se há conectividade com os pontos de extremidade específicos do seu título. Recomendamos que, após aguardar a inicialização da rede, você use WinSock e/ou WinHTTP para tentar estabelecer uma conexão com o ponto de extremidade, independentemente do estado do campo XNetworkingConnectivityHint::connectivityLevelHint. Se essas APIs falharem posteriormente, recomendamos que você use a API XNetworkingGetConnectivityHint para fins adicionais de interface do usuário e relatórios de diagnóstico. Em seguida, aguarde uma alteração no nível de conectividade de rede antes de tentar novamente.
Esse método consulta o estado local no processo de chamada e retorna rapidamente, portanto, é seguro chamá-lo a partir de contextos sensíveis ao tempo.
Requisitos
Cabeçalho: XNetworking.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Recuperando informações de redeXNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking