XNetworkingConnectivityHintChangedCallback

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

语法

void XNetworkingConnectivityHintChangedCallback(
         void* context,
         const XNetworkingConnectivityHint* connectivityHint
)

参数

context _In_opt_
类型：void*

传递到 XNetworkingRegisterConnectivityHintChanged 函数的可选上下文指针。

connectivityHint _In_
类型：XNetworkingConnectivityHint*

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

返回值

类型：void

备注

当有关设备当前连接的某些内容发生更改时，将调用此回调函数。 它包括调用注册函数时传递的上下文指针。 此回调的触发并不保证从上次回调触发后发生了更改。

注意

尽最大努力与网络和网络连接级别的当前设备范围状态有关。 请务必注意，网络初始化并不是最佳效果，因为初始化十分常见。

返回的 XNetworkingConnectivityHint 结构中的字段（XNetworkingConnectivityHint::networkInitialized 字段除外）是提示内容。 这些提示是设备根据设备上网络流量摘要对当前网络状态的最佳推测。 重要的是，这些字段并不表示是否存在到特定游戏终结点的连接。 我们建议在网络初始化后，无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何，都使用 WinSock 和/或 WinHTTP 来尝试建立与终结点的连接。 如果这些 API 后来失败了，我们建议您将 XNetworkingGetConnectivityHint API 用于其他 UI 和诊断报告目的。 然后，您应等到网络连接级别发生变化之后，再重试。

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

要求

头文件：XNetworking.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

检索网络信息
XNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking