XNetworkingConnectivityHint
定义网络的当前设备范围内状态，包括网络连接级别、数据限制、接口类型和网络初始化状态。
语法
typedef struct XNetworkingConnectivityHint {
XNetworkingConnectivityLevelHint connectivityLevel;
XNetworkingConnectivityCostHint connectivityCost;
uint32_t ianaInterfaceType;
bool networkInitialized;
bool approachingDataLimit;
bool overDataLimit;
bool roaming;
} XNetworkingConnectivityHint
成员
connectivityLevel
类型：XNetworkingConnectivityLevelHint
设备的当前最可能连接级别。
connectivityCost
类型：XNetworkingConnectivityCostHint
设备数据限制的当前最可能分类。
ianaInterfaceType
类型：uint32_t
有可能被 WinSock 和 WinHTTP 用来访问 Internet 的当前接口类型。 IANA NDIS 接口类型之一。
networkInitialized
类型：bool
确定网络当前是否初始化。 有关详细信息，请参阅检索网络信息的网络初始化部分。
approachingDataLimit
类型：bool
确定设备是否接近超出其数据限制。
overDataLimit
类型：bool
确定设备是否已超出其数据限制。
roaming
类型：bool
确定设备是否在漫游。
备注
尝试使用任何网络或安全 API 前，请确保 networkInitialized 成员返回 true。
注意
尝试对未初始化的网络使用 XNetworking API 将导致调用失败和不可预知的行为。
此结构是从 XNetworkingGetConnectivityHint API 以及来自注册器流的回调返回的。 有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息，请参阅检索网络信息。
返回的 XNetworkingConnectivityHint 结构中的字段（XNetworkingConnectivityHint::networkInitialized 字段除外）是提示内容。 这些提示是设备根据设备上网络流量摘要对当前网络状态的最佳推测。 重要的是，这些字段并不表示是否存在到特定游戏终结点的连接。 我们建议在网络初始化后，无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何，都使用 WinSock 和/或 WinHTTP 来尝试建立与终结点的连接。 如果这些 API 后来失败了，我们建议您将 XNetworkingGetConnectivityHint API 用于其他 UI 和诊断报告目的。 然后，你应等到网络连接级别发生变化之后再重试。
要求
头文件：XNetworking.h
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机