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

  • [アーティクル]

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

構文

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

パラメーター

[out] pdwFlags

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

値 意味
Zero
 コールバックの完了には時間がかかりませんが、システムが呼び出す内容に関する特定の制限はありません。 通常、コールバックの完了には 30 ミリ秒未満かかります。
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 コールバックは処理を最小限に抑えています。 完了までに 1 ミリ秒未満かかります。

コールバックは、次のいずれかの作業キューから呼び出す必要があります。

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 MFASYNC_FAST_IO_PROCESSING_CALLBACKを意味し、コールバックが処理を行わないという追加の制限 (50 マイクロ秒未満) と、それが行う唯一のシステム呼び出しは SetEvent です。

コールバックは、次のいずれかの作業キューから呼び出す必要があります。

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 コールバックをブロックしています。
MFASYNC_REPLY_CALLBACK
 応答コールバック。

[out] pdwQueue

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

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

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

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
E_NOTIMPL
 実装されていません。 既定の動作を想定します。

注釈

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 の更新プログラムのロールアップ) がインストールされています。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfobjects.h (Mfidl.h を含む)
Library Mfuuid.lib

こちらもご覧ください

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

IMFAsyncCallback

作業キュー