次の方法で共有

XTaskQueueUnregisterMonitor

  • [アーティクル]

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

構文

void XTaskQueueUnregisterMonitor(  
         XTaskQueueHandle queue,  
         XTaskQueueRegistrationToken token  
)

パラメーター

queue _In_
型: XTaskQueueHandle

送信コールバックを削除するキュー。

token _In_
型: XTaskQueueRegistrationToken

XTaskQueueRegisterMonitor から返された登録トークン。

戻り値

型: void

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

タスク キューの XTaskQueueMonitorCallback コールバックを登録するために XTaskQueueRegisterMonitor が以前呼び出されていた場合は、XTaskQueueUnregisterMonitor を使用してコールバックを登録解除します。 登録解除されると、実行するタスクがタスク キューに送信されるときに、コールバックが呼び出されなくなります。 コールバックの登録を解除すると、タスク キュー ハンドルへの参照も解放されます。

注意

XTaskQueueRegisterMonitor を呼び出して XTaskQueueMonitorCallback コールバックをタスク キューに登録する場合は、XTaskQueueCloseHandle を使用してタスク キュー ハンドルを閉じる前に、XTaskQueueUnregisterMonitor を使用してコールバックの登録を解除する必要があります。そうしなければメモリ リークが発生する可能性があります。 タスク キュー ハンドルは共有可能なリソースです。そのハンドルへのすべての参照が解放されるまで実際には破棄されません。 詳細については、「非同期タスク キューの設計」を参照してください。

要件

ヘッダー: XTaskQueue.h

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
XTaskQueue のメンバー
非同期プログラミング モデル
非同期タスク キューの設計