XNetworkingRegisterConnectivityHintChanged
为游戏注册关于当前网络连接级别、数据限制、接口类型和网络初始化状态等设备级信息变更的通知。语法
参数
queue _In_opt_类型：XTaskQueueHandle 连接提示发生变更时用于放置回调的队列。 context _In_opt_
类型：void* 要传递给回调的可选上下文指针。 callback _In_
类型：XNetworkingConnectivityHintChangedCallback* 在连接提示变更时调用的函数。 token _Out_
类型：XTaskQueueRegistrationToken* 用于在取消注册时标识该回调的令牌。
返回值
类型：HRESULT HRESULT 成功或错误代码。备注
此函数用于注册“连接提示已更改”通知，并发送初始通知回调。 若要取消注册回调，请使用 XNetworkingUnregisterConnectivityHintChanged。 返回的XNetworkingConnectivityHint 结构体中的字段（XNetworkingConnectivityHint::networkInitialized 字段除外）都是提示。它们是设备基于对设备网络流量的汇总所做出的、关于当前网络状态的尽力而为的推断。重要的是，这些字段并不代表是否能够连接到你的特定游戏端点。我们建议：在等待网络初始化完成后，无论 XNetworkingConnectivityHint::connectivityLevelHint 字段的状态如何，都使用 WinSock 和/或 WinHTTP 尝试与端点建立连接。如果这些 API 随后失败，我们建议再使用 XNetworkingGetConnectivityHint API 来提供额外的 UI 与诊断报告信息。然后你应等待网络连接级别发生变化后再重试。
有关网络初始化的更多信息，请参阅网络初始化和连接。
此方法查询调用进程中的本地状态并快速返回，因此可以从时间敏感的上下文中安全调用。
要求
头文件： XNetworking.h 库： xgameruntime.lib 支持的平台： Windows、XBOX One 系列主机和 XBOX Series 主机另请参阅
XNetworkingGetConnectivityHintXNetworkingUnregisterConnectivityHintChanged
XNetworking