XNetworkingConnectivityHintChangedCallback
在连接提示结构发生更改时被调用。语法
参数
context _In_opt_类型:void* 传递给 XNetworkingRegisterConnectivityHintChanged 函数的可选上下文指针。 connectivityHint _In_
类型:XNetworkingConnectivityHint* 新的设备范围连接提示结构。
返回值
类型:void备注
当设备当前连接的某些方面发生变化时,将调用此回调函数。它包含调用注册函数时传递的上下文指针。此回调的触发并不能保证自上次回调触发以来发生了变化。尽力而为适用于网络和网络连接级别的当前设备范围状态。必须尊重网络初始化不是尽力而为的,因为初始化可能偶尔不会发生。
XNetworkingConnectivityHint 结构中的字段(XNetworkingConnectivityHint::networkInitialized 字段除外)是提示。它们是设备根据设备上网络流量的摘要对网络当前状态的尽力猜测。重要的是,这些字段不代表是否可连接到你特定游戏的终结点。我们建议在等待网络初始化完成后,你使用 WinSock 和/或 WinHTTP 尝试与你的终结点建立连接,无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何。如果那些 API 随后失败,我们建议然后使用 XNetworkingGetConnectivityHint API 用于额外的 UI 和诊断报告目的。然后你应等待网络连接级别的变化后再重试。
此方法查询调用进程内的本地状态并快速返回,因此可从时间敏感的上下文中安全调用。
要求
头文件: XNetworking.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机另请参阅
检索网络信息XNetworkingGetConnectivityHint
XNetworkingRegisterConnectivityHintChanged
XNetworkingUnregisterConnectivityHintChanged
XNetworking
