IMFAsyncCallback::GetParameters メソッド (mfobjects.h)

コールバックのディスパッチ スレッドに構成情報を提供します。

構文

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

パラメーター

[out] pdwFlags

コールバック オブジェクトの IMFAsyncCallback::Invoke メソッドの動作を示すフラグを受け取ります。 次の値が定義されています。 既定値はゼロです。

[out] pdwQueue

コールバックがディスパッチされる作業キューの識別子を受け取ります。

この値では、標準の Media Foundation 作業キューのいずれか、またはアプリケーションによって作成された作業キューを指定できます。 標準の Media Foundation 作業キューの一覧については、「 Work Queue Identifiers」を参照してください。 新しい作業キューを作成するには、 MFAllocateWorkQueue を呼び出します。 既定値は MFASYNC_CALLBACK_QUEUE_STANDARDです。

作業キューが pdwFlags で返される値と互換性がない場合、Media Foundation プラットフォームはコールバックをディスパッチしようとしたときに MF_E_INVALID_WORKQUEUE を返します。 ( MFPutWorkItem を参照)。

戻り値

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

注釈

GetParameters メソッドはコールバックに関する情報を返し、ディスパッチ スレッドがコールバックの呼び出しに使用するプロセスを最適化できるようにします。

メソッドが pdwFlags パラメーターで 0 以外の値を返す場合、Invoke メソッドはここで説明する要件を満たす必要があります。 そうしないと、コールバックによってパイプラインが遅延する可能性があります。

両方のパラメーターの既定値が必要な場合は、 E_NOTIMPLを返します。 既定値は、このページのパラメーターの説明で指定します。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

• Windows XP Service Pack 2 (SP2) 以降。
• Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

こちらもご覧ください

非同期コールバック メソッド

IMFAsyncCallback

作業キュー