> ## 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

在连接提示结构发生更改时被调用。

## 语法

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

### 参数

*context*   \_In\_opt\_\
类型：void\*

传递给 [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) 函数的可选上下文指针。

*connectivityHint*   \_In\_\
类型：[XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

新的设备范围连接提示结构。

### 返回值

类型：void

## 备注

当设备当前连接的某些方面发生变化时，将调用此回调函数。它包含调用注册函数时传递的上下文指针。此回调的触发并不能保证自上次回调触发以来发生了变化。

<Note>尽力而为适用于网络和网络连接级别的当前设备范围状态。必须尊重网络初始化不是尽力而为的，因为初始化可能偶尔不会发生。</Note>

返回的 `XNetworkingConnectivityHint` 结构中的字段（`XNetworkingConnectivityHint::networkInitialized` 字段除外）是提示。它们是设备根据设备上网络流量的摘要对网络当前状态的尽力猜测。重要的是，这些字段不代表是否可连接到你特定游戏的终结点。我们建议在等待网络初始化完成后，你使用 WinSock 和/或 WinHTTP 尝试与你的终结点建立连接，无论 `XNetworkingConnectivityHint::connectivityLevelHint` 字段的状态如何。如果那些 API 随后失败，我们建议然后使用 `XNetworkingGetConnectivityHint` API 用于额外的 UI 和诊断报告目的。然后你应等待网络连接级别的变化后再重试。

此方法查询调用进程内的本地状态并快速返回，因此可从时间敏感的上下文中安全调用。

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[检索网络信息](/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingUnregisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworking](/zh-CN/reference/networking/xnetworking/xnetworking_members.md)
- [XNetworkingGetConnectivityHint](/zh-CN/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityHint](/zh-CN/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)