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