IMFMediaEvent

Media Foundation オブジェクトによって生成されたイベントを表します。イベントに関する情報を取得するには、このインターフェイスを使用します。

イベントを生成するオブジェクトを実装している場合は、MFCreateMediaEvent 関数を呼び出して新しいイベント オブジェクトを作成します。

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

• Windows XP with Service Pack 2 (SP2) 以降。
• KB900325 (Windows XP Media Center Edition 2005) および KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) がインストールされた Windows XP Media Center Edition 2005。

イベントの種類を取得します。イベントの種類は、イベントを発生させた原因を示します。また、イベント値の意味も定義します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

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

• Windows XP with Service Pack 2 (SP2) 以降。
• KB900325 (Windows XP Media Center Edition 2005) および KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) がインストールされた Windows XP Media Center Edition 2005。

イベントの拡張型を取得します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

カスタム イベントを定義するには、新しい拡張型 GUID を作成し、その GUID を指定して MEExtendedType イベントを送信します。

一部の標準的な Media Foundation イベントも、イベント データの種類を区別するために拡張型を使用します。

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

• Windows XP with Service Pack 2 (SP2) 以降。
• KB900325 (Windows XP Media Center Edition 2005) および KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) がインストールされた Windows XP Media Center Edition 2005。

イベントのステータスを指定する HRESULT を取得します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

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

• Windows XP with Service Pack 2 (SP2) 以降。
• KB900325 (Windows XP Media Center Edition 2005) および KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) がインストールされた Windows XP Media Center Edition 2005。

イベントに関連付けられた値がある場合、その値を取得します。値は PROPVARIANT 構造体として取得されます。実際のデータ型と値の意味は、イベントによって異なります。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

このメソッドを呼び出す前に、PropVariantInit を呼び出して PROPVARIANT 構造体を初期化してください。メソッドが返った後は、PropVariantClear を呼び出して PROPVARIANT データに割り当てられたメモリを解放してください。

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

• Windows XP with Service Pack 2 (SP2) 以降。
• KB900325 (Windows XP Media Center Edition 2005) および KB925766 (October 2006 Update Rollup for Windows XP Media Center Edition) がインストールされた Windows XP Media Center Edition 2005。

例

次の関数は、イベント値が IUnknown ポインターである場合に、その値を取得します。PROPVARIANT 型が VT_UNKOWN でない場合、関数は MF_E_INVALIDTYPE を返します。

//  Gets an IUnknown pointer from an IMFMediaEvent event and queries 
//  the pointer for a specified interface.
//
//  NOTE: Applies only to events that contain IUnknown pointers.
//        Otherwise, the function returns MF_E_INVALIDTYPE.

template <class Q>
HRESULT GetEventObject(IMFMediaEvent *pEvent, Q **ppObject)
{
    *ppObject = NULL;   // zero output

    PROPVARIANT var;
    HRESULT hr = pEvent->GetValue(&var);
    if (SUCCEEDED(hr))
    {
        if (var.vt == VT_UNKNOWN)
        {
            hr = var.punkVal->QueryInterface(ppObject);
        }
        else
        {
            hr = MF_E_INVALIDTYPE;
        }
        PropVariantClear(&var);
    }
    return hr;
}