IMFMediaEventQueue::QueueEventParamVar メソッド (mfobjects.h)

イベントを作成し、 PROPVARIANT をイベント データとして設定し、イベントをキューに格納します。

IMFMediaEventGenerator::QueueEvent の実装内でこのメソッドを呼び出します。 そのメソッドからこのメソッドに直接パラメーターを渡します。

また、属性を含まないイベントをコンポーネントで発生させる必要がある場合は、このメソッドを呼び出すこともできます。 イベント データが IUnknown ポインターの場合は、 IMFMediaEventQueue::QueueEventParamUnk を使用できます。 イベントに属性が含まれている場合は、代わりに IMFMediaEventQueue::QueueEvent を 使用します。

構文

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

パラメーター

[in] met

キューに追加するイベントの種類を指定します。 イベントの種類は、イベントの IMFMediaEvent::GetType メソッドによって返されます。 イベントの種類の一覧については、「 Media Foundation イベント」を参照してください。

[in] guidExtendedType

イベントの拡張型。 イベントに拡張型がない場合は、GUID_NULL値を使用します。 拡張型は、イベントの IMFMediaEvent::GetExtendedType メソッドによって返されます。

[in] hrStatus

イベントの状態を示す成功または失敗コード。 この値は、イベントの IMFMediaEvent::GetStatus メソッドによって返されます。

[in] pvValue

イベント値を含む PROPVARIANT へのポインター。 このパラメーターは、NULL でもかまいません。 この値は、イベントの IMFMediaEvent::GetValue メソッドによって返されます。

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
MF_E_SHUTDOWN	Shutdown メソッドが呼び出されました。

注釈

このインターフェイスは、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

こちらもご覧ください

IMFMediaEventQueue