针对设备范围内有关当前网络连接级别、数据限制、接口类型和网络初始化状态的信息的更改，注册游戏。
语法
HRESULT XNetworkingRegisterConnectivityHintChanged(
XTaskQueueHandle queue,
void* context,
XNetworkingConnectivityHintChangedCallback* callback,
XTaskQueueRegistrationToken* token
)
参数
queue _In_opt_
类型：XTaskQueueHandle
连接提示更改时要在其中放置回调的队列。
context _In_opt_
类型：void*
传递到回调的可选上下文指针。
callback _In_
类型：XNetworkingConnectivityHintChangedCallback*
连接提示更改时要调用的函数。
token _Out_
类型：XTaskQueueRegistrationToken*
注销时用于标识回调的令牌。
返回值
类型：HRESULT
HRESULT 成功或错误代码。
备注
此函数注册“连接提示已更改”通知并发送初始通知回调。
若要注销回调，请使用 XNetworkingUnregisterConnectivityHintChanged。
返回的 XNetworkingConnectivityHint 结构中的字段（XNetworkingConnectivityHint::networkInitialized 字段除外）是提示内容。 这些提示是设备根据设备上网络流量摘要对当前网络状态的最佳推测。 重要的是，这些字段并不表示是否存在到特定游戏终结点的连接。 我们建议在网络初始化后，无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何，都使用 WinSock 和/或 WinHTTP 来尝试建立与终结点的连接。 如果这些 API 后来失败了，我们建议您将 XNetworkingGetConnectivityHint API 用于其他 UI 和诊断报告目的。 然后，您应等到网络连接级别发生变化之后，再重试。
有关网络初始化的详细信息，请参阅网络初始化和连接。
该方法在调用进程内询问本地状态并快速返回，因此可以安全地从时间敏感上下文调用它。
要求
头文件：XNetworking.h
库：xgameruntime.lib
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
XNetworkingGetConnectivityHint
XNetworkingUnregisterConnectivityHintChanged
XNetworking