Skip to main content

XTaskQueueSetCurrentProcessTaskQueue

指定されたタスク キューをプロセス全体のタスク キューとして設定します。

構文

パラメーター

queue   _In_
Type: XTaskQueueHandle
プロセスの既定のタスク キューとして設定するキューです。

戻り値

Type: void

解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
キューを nullptr に設定することもでき、その場合 XTaskQueueGetCurrentProcessTaskQueue も nullptr を返します。指定されたキューはハンドルが複製され、既存のプロセス タスク キューがある場合はそのハンドルは閉じられます。 次の例では、既定のプロセス タスク キューを置き換えます。このタスク キューは、ワーク ディスパッチと完了ディスパッチの両方にスレッド プールを使用します。タスク キュー パラメーターを取る Microsoft Game Development Kit (GDK) API はすべて nullptr を受け付けて、プロセス タスク キューで代替します。プロセス タスク キューは nullptr に設定することも可能で、その場合、タスク キュー パラメーターを必要とする Microsoft Game Development Kit (GDK) API は、null が指定されると E_NO_TASK_QUEUE でエラーとなります。これにより、Microsoft Game Development Kit (GDK) API は既定で動作しつつ、必要に応じてタスク キュー ハンドルを厳密に制御することもできます。

要件

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

概念ドキュメント

関連項目

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