MFBeginRegisterWorkQueueWithMMCSSEx 関数 (mfapi.h)

作業キューをマルチメディア クラス スケジューラ サービス (MMCSS) タスクに関連付けます。

構文

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

パラメーター

[in] dwWorkQueueId

作業キューの識別子。 プライベート作業キューの場合、 識別子は MFAllocateWorkQueue 関数によって返されます。 プラットフォーム作業キューについては、「 Work Queue Identifiers」を参照してください。

[in] wszClass

MMCSS タスクの名前。 詳細については、「 マルチメディア クラス スケジューラ サービス」を参照してください。

[in] dwTaskId

一意のタスク識別子。 新しいタスク識別子を取得するには、この値を 0 に設定します。

[in] lPriority

作業キュー スレッドの基本相対優先度。 詳細については、「 AvSetMmThreadPriority」を参照してください。

[in] pDoneCallback

コールバック オブジェクトの IMFAsyncCallback インターフェイスへのポインター。 呼び出し元は、このインターフェイスを実装する必要があります。

[in] pDoneState

呼び出し元によって定義された状態オブジェクトの IUnknown インターフェイスへのポインター。 このパラメーターは、NULL でもかまいません。 このオブジェクトを使用して、状態情報を保持できます。 コールバックが呼び出されると、オブジェクトが呼び出し元に返されます。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

この関数は、lPriority パラメーターを追加して MFBeginRegisterWorkQueueWithMMCSS 関数を拡張します。

この関数は非同期です。 操作が完了すると、コールバック オブジェクトの IMFAsyncCallback::Invoke メソッドが呼び出されます。 その時点で、 MFEndRegisterWorkQueueWithMMCSS を呼び出して非同期要求を完了します。

MMCSS タスクから作業キューの登録を解除するには、 MFBeginUnregisterWorkQueueWithMMCSS を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfapi.h
[DLL]	Mfplat.dll

こちらもご覧ください

メディア ファンデーション機能

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

作業キュー