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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

注釈

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

要件

こちらもご覧ください

IMFMediaEventQueue