IMFWorkQueueServices::BeginRegisterPlatformWorkQueueWithMMCSS メソッド (mfidl.h)

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

構文

HRESULT BeginRegisterPlatformWorkQueueWithMMCSS(
  [in] DWORD            dwPlatformWorkQueue,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

パラメーター

[in] dwPlatformWorkQueue

MMCSS に登録するプラットフォーム作業キュー。 「作業キュー識別子」を参照してください。 すべての標準作業キューを同じ MMCSS タスクに登録するには、このパラメーターを MFASYNC_CALLBACK_QUEUE_ALL に設定します。

[in] wszClass

実行する MMCSS タスクの名前。

[in] dwTaskId

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

[in] pCallback

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

[in] pState

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

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

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

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

要件

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

関連項目

IMFWorkQueueServices