> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConnectivityHintChangedCallback

> XNetworkingConnectivityHintChangedCallback

# XNetworkingConnectivityHintChangedCallback

É chamado quando a estrutura de dica de conectividade é alterada.

## Sintaxe

```cpp theme={null}
void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)
```

### Parâmetros

*context*   \_In\_opt\_\
Tipo: void\*

Um ponteiro de contexto opcional que foi passado para a função [XNetworkingRegisterConnectivityHintChanged](/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged).

*connectivityHint*   \_In\_\
Tipo: [XNetworkingConnectivityHint](/pt-BR/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

A nova estrutura de dica de conectividade de todo o dispositivo.

### Valor retornado

Tipo: void

## Comentá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.

<Note>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.</Note>

Os campos na estrutura `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 Series

## Confira também

[Recuperando informações de rede](/pt-BR/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingGetConnectivityHint](/pt-BR/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingRegisterConnectivityHintChanged](/pt-BR/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingUnregisterConnectivityHintChanged](/pt-BR/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/pt-BR/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)