> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingConnectivityHint

> XNetworkingConnectivityHint

# XNetworkingConnectivityHint

定义当前设备级别的网络状态，包括网络连接级别、数据限制、接口类型和网络初始化状态。

## 语法

```cpp theme={null}
typedef struct XNetworkingConnectivityHint {
    XNetworkingConnectivityLevelHint connectivityLevel;
    XNetworkingConnectivityCostHint connectivityCost;
    uint32_t ianaInterfaceType;
    bool networkInitialized;
    bool approachingDataLimit;
    bool overDataLimit;
    bool roaming;
} XNetworkingConnectivityHint
```

### 成员

*connectivityLevel*\
类型：[XNetworkingConnectivityLevelHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)

设备当前的尽力而为的连接级别。

*connectivityCost*\
类型：[XNetworkingConnectivityCostHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)

对设备当前数据限制的尽力而为的分类。

*ianaInterfaceType*\
类型：uint32\_t

WinSock 和 WinHTTP 到达 internet 时可能使用的当前接口类型。是 [IANA NDIS 接口类型](https://learn.microsoft.com/windows-hardware/drivers/network/ndis-interface-types)之一。

*networkInitialized*\
类型：bool

指示网络当前是否已初始化。有关详细信息，请参阅[检索网络信息](https://docs.xbox.com/zh-CN/build/console-features/networking/initialization-connectivity-networking.md)中的[网络初始化](https://docs.xbox.com/zh-CN/build/console-features/networking/initialization-connectivity-networking.md)一节。

*approachingDataLimit*\
类型：bool

指示设备是否接近超出其数据限制。

*overDataLimit*\
类型：bool

指示设备是否已超出其数据限制。

*roaming*\
类型：bool

指示设备是否处于漫游状态。

## 备注

在尝试使用任何网络或安全 API 之前，请确保 *networkInitialized* 成员返回 true。

> [!NOTE]
>
> 尝试使用尚未初始化的网络的 XNetworking API 将导致调用失败和不可预测的行为。

此结构体由 [XNetworkingGetConnectivityHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md) API 返回，也可作为从注册流程返回的回调参数。有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息，请参阅[检索网络信息](https://docs.xbox.com/zh-CN/build/console-features/networking/initialization-connectivity-networking.md)。

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

## 要求

**头文件：** XNetworking.h

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

## 另请参阅

[XNetworking](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingGetConnectivityHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [XNetworkingConnectivityCostHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitycosthint.md)
- [XNetworkingConnectivityLevelHint](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/enums/xnetworkingconnectivitylevelhint.md)
- [XNetworkingRegisterConnectivityHintChanged](https://docs.xbox.com/zh-CN/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)