作業キュー識別子

  • [アーティクル]

次の定数は、標準の Media Foundation 作業キューを識別します。

アプリケーションでは、実行優先度を制御する場合は、MFASYNC_CALLBACK_QUEUE_MULTITHREADEDを使用するか、 MFLockSharedWorkQueue から取得した作業キューを使用する必要があります。 アプリケーションが RegisterPlatformWithMMCSS を呼び出すと、既定のプラットフォーム作業キューの優先順位が動的に変更される可能性があることに注意してください。 作業キューの詳細については、「 作業キュー」を参照してください。

定数/値 Description
MFASYNC_CALLBACK_QUEUE_STANDARD
0x00000001
 ほとんどの場合、アプリケーションでは MFASYNC_CALLBACK_QUEUE_MULTITHREADEDを使用する必要があります。
この作業キューは同期操作に使用されます。 標準の作業キューを使用すると、デッドロックのリスクが発生する可能性があります。 アプリケーションでは、 MFAllocateSerialWorkQueue を使用して、マルチスレッド キューの上にプライベート同期キューを作成できます。
MFASYNC_CALLBACK_QUEUE_RT
0x00000002
 一般的なアプリケーションでは使用できません。
MFASYNC_CALLBACK_QUEUE_IO
0x00000003
 一般的なアプリケーションでは使用できません。
この作業キューは、ファイルの読み取りやネットワークからの読み取りなどの I/O 操作に内部的に使用されます。
MFASYNC_CALLBACK_QUEUE_TIMER
0x00000004
 一般的なアプリケーションでは使用できません。
この作業キューは、定期的なコールバックとスケジュールされた作業項目に使用されます。 次の関数は、このキューに作業項目を配置します。
MFASYNC_CALLBACK_QUEUE_MULTITHREADED
0x00000005
 このマルチスレッド作業キューは、ほとんどの場合に使用する必要があります。
この作業キューは、Media Foundation 全体の非同期操作に使用されます。
MFASYNC_CALLBACK_QUEUE_LONG_FUNCTION
0x00000007
 一般的なアプリケーションでは使用できません。 アプリケーションでは、代わりに MFASYNC_CALLBACK_QUEUE_MULTITHREADED を使用 する必要があります。

さらに、作業キューに関連して、次の定数が使用されます。

定数/値 Description
MFASYNC_CALLBACK_QUEUE_UNDEFINED
0x00000000
 未定義の作業キュー。
MFASYNC_CALLBACK_QUEUE_PRIVATE_MASK
0xFFFF0000
 MFAllocateWorkQueue を呼び出して作成されたものとプラットフォーム作業キューを区別するためのビット マスク。
MFAllocateWorkQueue によって作成された作業キューの場合、次の値は 0 以外です。
(identifier & MFASYNC_CALLBACK_QUEUE_PRIVATE_MASK)
MFASYNC_CALLBACK_QUEUE_ALL
0xFFFFFFFF
 すべてのプラットフォーム作業キュー。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー
Mfobjects.h (Mfidl.h を含む)

関連項目

Media Foundation 定数

作業キュー

作業キューとスレッド処理の機能強化