MFAllocateWorkQueueEx 関数 (mfapi.h)

新しい作業キューを作成します。この関数は、メッセージループを含む作業キューを作成できるようにすることで、MFAllocateWorkQueue 関数の機能を拡張します。

構文

HRESULT MFAllocateWorkQueueEx(
  [in]  MFASYNC_WORKQUEUE_TYPE WorkQueueType,
  [out] DWORD                  *pdwWorkQueue
);

[in] WorkQueueType

作成する作業キューの種類を指定する、 MFASYNC_WORKQUEUE_TYPE 列挙のメンバー。

値	意味
MF_MULTITHREADED_WORKQUEUE	マルチスレッド作業キューを作成します。一般に、アプリケーションではプライベートマルチスレッドキューを作成しないでください。代わりに、プラットフォームのマルチスレッドキューを使用してください。詳細については、「作業キューとスレッドの機能強化」を参照してください。
MF_STANDARD_WORKQUEUE	メッセージループを使用せずに作業キューを作成します。このフラグの使用は、 MFAllocateWorkQueue を呼び出すことと同じです。
MF_WINDOW_WORKQUEUE	メッセージループを使用して作業キューを作成します。このキューの作業項目をディスパッチするスレッドは、 PeekMessage と DispatchMessage も呼び出します。コールバックがメッセージループを必要とするアクションを実行する場合は、このオプションを使用します。

[out] pdwWorkQueue

作成された作業キューの識別子を受け取ります。

関数は HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	関数が正常に実行されました。
E_FAIL	アプリケーションが作業キューの最大数を超えました。
E_INVALIDARG	引数が無効です。
MF_E_SHUTDOWN	アプリケーションが MFStartup を呼び出さなかったか、アプリケーションが既に MFShutdown を呼び出しています。

作業キューの使用が完了したら、 MFUnlockWorkQueue を呼び出します。

MFAllocateWorkQueue 関数は、WorkQueueType パラメーターの値MF_STANDARD_WORKQUEUEを使用して MFAllocateWorkQueueEx を呼び出すことと同じです。

この関数は、Windows Vista のプラットフォーム更新プログラムの補足情報がインストールされている場合、Windows Vista で使用できます。

要件	値
サポートされている最小のクライアント	Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足情報 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfapi.h
Library	Mfplat.lib
[DLL]	Mfplat.dll