Skip to main content

XTaskQueueUnregisterMonitor

以前に登録されたモニター コールバックを登録解除します。

構文

パラメーター

queue   _In_
Type: XTaskQueueHandle
送信コールバックを削除するキューです。 token   _In_
Type: XTaskQueueRegistrationToken
XTaskQueueRegisterMonitor から返された登録トークンです。

戻り値

Type: void

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
以前に XTaskQueueRegisterMonitor を呼び出してタスク キューに XTaskQueueMonitorCallback コールバックを登録している場合、XTaskQueueUnregisterMonitor を使用してコールバックを登録解除します。登録解除されると、タスクが実行のためにタスク キューに送信されてもコールバックは呼び出されなくなります。コールバックの登録解除により、タスク キュー ハンドルへの参照も解放されます。
XTaskQueueRegisterMonitor を呼び出してタスク キューに XTaskQueueMonitorCallback コールバックを登録した場合、XTaskQueueCloseHandle でタスク キュー ハンドルを閉じる前に、XTaskQueueUnregisterMonitor を使用してコールバックを登録解除する必要があります。そうしないと、メモリ リークが発生する可能性があります。タスク キュー ハンドルは共有可能なリソースであり、そのハンドルへのすべての参照が解放されるまで実際には破棄されません。詳細については、非同期タスク キューの設計 を参照してください。

要件

ヘッダー: XTaskQueue.h サポートされているプラットフォーム: Windows、XBOX One 本体、XBOX Series 本体

概念ドキュメント

関連項目

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
XTaskQueue members
非同期プログラミング モデル
非同期タスク キューの設計
最終更新日 2026年8月24日