Skip to main content

XNetworkingGetConnectivityHint

查询有关当前网络连接级别、数据限制、接口类型和网络初始化状态的设备范围信息。

语法

参数

connectivityHint _Out_
类型:XNetworkingConnectivityHint*
网络的当前设备范围状态。

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

此函数返回有关网络连接级别、数据限制、有线与无线连接以及网络是否已初始化的设备范围信息。你可以使用 XNetworkingRegisterConnectivityHintChangedXNetworkingUnregisterConnectivityHintChanged 函数侦听更改。 返回的 XNetworkingConnectivityHint 结构中的字段(XNetworkingConnectivityHint::networkInitialized 字段除外)是提示。它们是设备根据设备上网络流量的摘要对网络当前状态的尽力猜测。重要的是,这些字段不代表是否可连接到你特定游戏的终结点。我们建议在等待网络初始化完成后,你使用 WinSock 和/或 WinHTTP 尝试与你的终结点建立连接,无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何。如果那些 API 随后失败,我们建议然后使用 XNetworkingGetConnectivityHint API 用于额外的 UI 和诊断报告目的。然后你应等待网络连接级别的变化后再重试。 有关网络初始化的详细信息,请参阅网络初始化和连接 此方法查询调用进程内的本地状态并快速返回,因此可从时间敏感的上下文中安全调用。

要求

头文件: XNetworking.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

另请参阅

XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
检测网络初始化状态
XNetworking
最后修改于 2026年8月24日