MFBeginRegisterWorkQueueWithMMCSS 関数 (mfapi.h)

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

構文

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

パラメーター

[in] dwWorkQueueId

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

[in] wszClass

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

[in] dwTaskId

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

[in] pDoneCallback

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

[in] pDoneState

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

戻り値

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

リターン コード	説明
S_OK	関数が正常に実行されました。

解説

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

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

要件

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

関連項目

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

作業キュー