XTaskQueueDispatchMode

タスクキューのコールバックがどのように処理されるかを記述します。

構文

typedef enum class XTaskQueueDispatchMode  : uint32_t  
{  
    Manual,  
    ThreadPool,  
    SerializedThreadPool,  
    Immediate  
} XTaskQueueDispatchMode  

定数

定数	説明
Manual	コールバックは自動的にはディスパッチされません。このディスパッチモードを使用してポートに送信されたコールバックはキューに登録されますが、XTaskQueueDispatch によって手動でディスパッチする必要があります。注: Windows メッセージをポンプするスレッドがある場合: ワークポートに対するコールバックをディスパッチしないでください完了ポートに対するコールバックをディスパッチする場合は、そのスレッドで Windows メッセージのポンプを継続する必要があります詳細については、手動タスクキューの作成を参照してください。
ThreadPool	このディスパッチモードを使用してポートに送信されたコールバックはキューに登録され、システムスレッドキューで自動的にディスパッチされます。タスクキューは呼び出しを並列に実行し、スレッドプールスレッドが利用可能になると順にタスクキューから呼び出しを取り出して実行します。スレッドプールタスクキューの作成に関する詳細については、スレッドプールタスクキューの作成を参照してください。
SerializedThreadPool	このディスパッチモードを使用してポートに送信されたコールバックはキューに登録され、システムスレッドキューで自動的にディスパッチされます。`ThreadPool` とは異なり、タスクキューはスレッドプール上で呼び出しを一度に 1 つずつ直列に実行します。
Immediate	コールバックはまったくキューに登録されず、送信元のスレッドで直ちに実行されます。イミディエイトディスパッチモードを実装する例については、コンポジットタスクキューの作成を参照してください。

解説

この列挙型は XTaskQueueCreate によって使用され、タスクキューのワークポートおよび完了ポートのディスパッチモードを指定します。ワークポートと完了ポートで異なるディスパッチモードを使用できます。たとえば、ワークポートにスレッドプールディスパッチモードを使用してシステムスレッドキューで自動的にコールバックをキューに登録して並列に実行し、完了ポートに手動ディスパッチモードを使用して Windows メッセージループスレッド上で手動でコールバックをキューに登録して実行することができます。詳細については、Windows メッセージループを使用したタスクキューの使用を参照してください。

要件

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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XTaskQueueDispatchMode

XTaskQueueDispatchMode

構文

定数

解説

要件

関連項目

​XTaskQueueDispatchMode

​構文

​定数

​解説

​要件

​関連項目

XTaskQueueDispatchMode

構文

定数

解説

要件

関連項目