Skip to main content

XTaskQueueUnregisterMonitor

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

Syntax

Parameters

queue   _In_
类型:XTaskQueueHandle
要从中移除提交回调的队列。 token   _In_
类型:XTaskQueueRegistrationToken
XTaskQueueRegisterMonitor 返回的注册令牌。

Return value

类型:void

Remarks

此函数在时间敏感线程上调用不安全。有关详细信息,请参阅时间敏感线程
如果先前已调用 XTaskQueueRegisterMonitor 为任务队列注册 XTaskQueueMonitorCallback 回调,则可使用 XTaskQueueUnregisterMonitor 取消注册该回调。取消注册后,向任务队列提交任务以供执行时,将不再调用该回调。取消注册回调还会释放其对任务队列句柄的引用。
如果调用 XTaskQueueRegisterMonitor 向任务队列注册 XTaskQueueMonitorCallback 回调,则必须先使用 XTaskQueueUnregisterMonitor 取消注册该回调,然后再使用 XTaskQueueCloseHandle 关闭任务队列句柄;否则,可能发生内存泄漏。任务队列句柄是可共享的资源,只有当对该句柄的所有引用都被释放后才实际销毁。有关详细信息,请参阅异步任务队列设计

Requirements

头文件: XTaskQueue.h 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
XTaskQueue 成员
异步编程模型
异步任务队列设计
最后修改于 2026年8月24日