XNetworkingUnregisterConnectivityHintChanged
取消注册通过 XNetworkingRegisterConnectivityHintChanged 注册的回调函数。语法
参数
token _In_类型:XTaskQueueRegistrationToken 从 XNetworkingRegisterConnectivityHintChanged 返回的令牌。 wait _In_
类型:bool 指示是否阻塞直到所有挂起的回调完成。
返回值
类型:bool 如果 wait 为 false 且取消注册调用处于挂起状态,则返回 false。否则返回 true。备注
此函数不能在时间敏感的线程上安全调用。有关详细信息,请参阅时间敏感线程。
- 从已注册的回调集合中移除与该令牌相关联的回调。
- 如果没有针对该回调令牌正在执行的回调,则该调用返回 true。
- 如果有回调正在执行且 wait 为 true,则该调用阻塞,直到正在执行的回调完成。
- 如果有回调正在执行且 wait 为 false,则该调用不阻塞,但会返回 false。当该令牌的回调完成后,令牌将被自动取消注册。
如果 wait 为 true,则不应在 XNetworkingConnectivityHintChangedCallback 内部调用此函数,否则会导致死锁。
- 你可以在取消注册时进行阻塞,以确保在取消注册调用之后不再调用你的回调。
- 你可以选择不阻塞。如果你需要在删除数据之前确保回调已完成,则可以定期以 wait 为 false 调用此函数。当它最终返回 true 时,你的所有回调都已完成,你就可以删除状态了。
- 如果你的回调不关心它是否在取消注册调用期间被调用,则可以为 wait 传入 false 并忽略返回值。
要求
头文件: XNetworking.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
XNetworkingRegisterConnectivityHintChangedXNetworkingGetConnectivityHint
网络初始化和连接
XNetworking
