通过

XTaskQueueUnregisterMonitor

  • 项目

取消注册以前注册的监视器回调。

语法

void XTaskQueueUnregisterMonitor(  
         XTaskQueueHandle queue,  
         XTaskQueueRegistrationToken token  
)

参数

queue _In_
类型：XTaskQueueHandle

要将提交回调从中删除的队列。

token _In_
类型：XTaskQueueRegistrationToken

从 XTaskQueueRegisterMonitor 返回的注册令牌。

返回值

类型：void

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。

如果先前已调用 XTaskQueueRegisterMonitor 来注册任务队列的 XTaskQueueMonitorCallback 回调，请使用 XTaskQueueUnregisterMonitor 来取消注册回调。 取消注册后，在任务提交到任务队列执行时，将不再调用回调。 取消注册回调也会释放其对任务队列句柄的引用。

注意

如果你调用 XTaskQueueRegisterMonitor 向任务队列注册 XTaskQueueMonitorCallback 回调，则必须在使用 XTaskQueueCloseHandle 关闭任务队列句柄之前，使用 XTaskQueueUnregisterMonitor 来取消注册回调；否则，可能发生内存泄漏。 任务队列句柄是可共享的资源，在释放对该句柄的所有引用之前并不会真正销毁。 有关详细信息，请参阅异步任务队列设计。

要求

头文件：XTaskQueue.h

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
XTaskQueue 成员
异步编程模型
异步任务队列设计