Skip to main content

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 主机

概念文档

另请参阅

XNetworkingRegisterConnectivityHintChanged
XNetworkingGetConnectivityHint
网络初始化和连接
XNetworking
最后修改于 2026年8月24日