XTaskQueueCallback
タスク キューによって呼び出されるコールバックです。構文
パラメーター
context _In_opt_Type: void* 省略可能。XTaskQueueSubmitCallback の呼び出し時に渡されたコンテキスト ポインター。 canceled _In_
Type: bool true の場合、タスク キューが終了処理中であるため、コールバックがキャンセルされていることを示します。
戻り値
Type: void解説
XTaskQueueCallback コールバックは、タスク キューで作業を実行するために実装されます。コールバックは、XTaskQueueSubmitCallback または XTaskQueueSubmitDelayedCallback を呼び出すことにより、タスク キューのワーク ポートまたは完了ポートのいずれにも送信できます。タスク キューのワーク ポートと完了ポートは独立したディスパッチ モードを持つことができ、XTaskQueueCallback コールバックはいずれのポートにも送信できます。通常、ワーク ポートに送信されたコールバックは、その作業を完了したときに対応するコールバックを完了ポートに送信します。
canceled パラメーターの目的は、コールバックがキャンセルされた場合に、コールバックによって割り当てられたリソースを適切に解放できるようにすることです。XTaskQueueCallback コールバックが呼び出され、canceled が true に設定されている場合、そのコールバックに対応するタスク キューは XTaskQueueTerminate の呼び出しによって終了されており、コールバックはキャンセルされています。コールバックは、context に割り当てられているメモリを含め、割り当てられているリソースをすべて解放し、それ以外の作業は行わないでください。
例については、コールバックの送信 を参照してください。
要件
ヘッダー: XTaskQueue.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One 本体、XBOX Series 本体関連項目
XTaskQueue members非同期プログラミング モデル
非同期タスク キューの設計