Skip to main content

XTaskQueueUnregisterMonitor

取消註冊先前註冊的監視器回呼。

語法

參數

queue   _In_
類型:XTaskQueueHandle
要從中移除提交回呼的佇列。 token   _In_
類型:XTaskQueueRegistrationToken
從 XTaskQueueRegisterMonitor 傳回的註冊權杖。

傳回值

類型:void

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
如果先前已叫用 XTaskQueueRegisterMonitor 為工作佇列註冊 XTaskQueueMonitorCallback 回呼,請使用 XTaskQueueUnregisterMonitor 取消註冊該回呼。取消註冊之後,當工作提交至工作佇列以供執行時,就不會再叫用該回呼。取消註冊回呼也會釋放其對工作佇列控制代碼的參考。
如果您呼叫 XTaskQueueRegisterMonitor 向工作佇列註冊 XTaskQueueMonitorCallback 回呼,則必須先使用 XTaskQueueUnregisterMonitor 取消註冊該回呼,再使用 XTaskQueueCloseHandle 關閉工作佇列控制代碼;否則可能會發生記憶體流失。工作佇列控制代碼是可共用的資源,在釋放該控制代碼的所有參考之前,不會真正被終結。如需詳細資訊,請參閱非同步工作佇列設計。

需求

標頭: XTaskQueue.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
XTaskQueue 成員
非同步程式設計模型
非同步工作佇列設計
Last modified on October 6, 2026