XNetworkingRegisterConnectivityHintChanged
Registra o título para receber alterações nas informações de todo o dispositivo sobre o nível atual de conectividade de rede, limites de dados, tipo de interface e estado de inicialização da rede.Sintaxe
Parâmetros
queue _In_opt_Tipo: XTaskQueueHandle A fila na qual colocar o retorno de chamada quando a dica de conectividade for alterada. context _In_opt_
Tipo: void* Ponteiro de contexto opcional a ser passado para o retorno de chamada. callback _In_
Tipo: XNetworkingConnectivityHintChangedCallback* Função a ser chamada quando a dica de conectividade for alterada. token _Out_
Tipo: XTaskQueueRegistrationToken* Token usado para identificar o retorno de chamada ao cancelar o registro.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
Essa função registra uma notificação de “dica de conectividade alterada” e envia um retorno de chamada de notificação inicial. Para cancelar o registro de um retorno de chamada, use XNetworkingUnregisterConnectivityHintChanged. Os campos na estruturaXNetworkingConnectivityHint 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.
Para obter mais informações sobre a inicialização da rede, confira Inicialização e conectividade de rede.
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
XNetworkingGetConnectivityHintXNetworkingUnregisterConnectivityHintChanged
XNetworking