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

# XNetworkingRegisterConnectivityHintChanged

> XNetworkingRegisterConnectivityHintChanged

# XNetworkingRegisterConnectivityHintChanged

为游戏注册关于当前网络连接级别、数据限制、接口类型和网络初始化状态等设备级信息变更的通知。

## 语法

```cpp theme={null}
HRESULT XNetworkingRegisterConnectivityHintChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingConnectivityHintChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### 参数

*queue*   \_In\_opt\_\
类型：XTaskQueueHandle

连接提示发生变更时用于放置回调的队列。

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

要传递给回调的可选上下文指针。

*callback*   \_In\_\
类型：XNetworkingConnectivityHintChangedCallback\*

在连接提示变更时调用的函数。

*token*   \_Out\_\
类型：[XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

用于在取消注册时标识该回调的令牌。

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

此函数用于注册“连接提示已更改”通知，并发送初始通知回调。

若要取消注册回调，请使用 [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)。

返回的 `XNetworkingConnectivityHint` 结构体中的字段（`XNetworkingConnectivityHint::networkInitialized` 字段除外）都是提示。它们是设备基于对设备网络流量的汇总所做出的、关于当前网络状态的尽力而为的推断。重要的是，这些字段并不代表是否能够连接到你的特定游戏端点。我们建议：在等待网络初始化完成后，无论 `XNetworkingConnectivityHint::connectivityLevelHint` 字段的状态如何，都使用 WinSock 和/或 WinHTTP 尝试与端点建立连接。如果这些 API 随后失败，我们建议再使用 `XNetworkingGetConnectivityHint` API 来提供额外的 UI 与诊断报告信息。然后你应等待网络连接级别发生变化后再重试。

有关网络初始化的更多信息，请参阅[网络初始化和连接](/build/console-features/networking/initialization-connectivity-networking)。

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

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

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

## 另请参阅

[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/zh-CN/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/zh-CN/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingGetConnectivityHint](/zh-CN/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [检测网络初始化状态](/zh-CN/build/console-features/networking/initialization-connectivity-networking.md)
- [XNetworking](/zh-CN/reference/networking/xnetworking/xnetworking_members.md)