Skip to main content

XTaskQueueSubmitCallback

指定されたポートのキューにコールバックを送信します。

構文

パラメーター

queue   _In_
Type: XTaskQueueHandle
コールバックを送信するキューです。 port   _In_
Type: XTaskQueuePort
コールバックを送信するポートです。コールバックはワーク ポートまたは完了ポートに割り当てることができます。 callbackContext   _In_opt_
Type: void*
コールバックに渡される省略可能なコンテキスト ポインターです。 callback   _In_
Type: XTaskQueueCallback*
コールバック関数へのポインターです。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。

解説

alert パフォーマンスに関する注:
上位のコードのパフォーマンス要件を満たすためには、キューへの項目の追加はロックフリーかつ待機フリーである必要があります。次の API はロックフリーです:
次の例では、タスク キューのワーク ポートまたは完了ポートのいずれかにコールバックを送信する方法を示します。まずワーク コールバックを送信し、そのワーク コールバックの最後で完了コールバックを送信します。これは一般的な使い方です。

要件

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

関連項目

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