知識マップ: Media Foundation入門 - COM視点でAPIを理解する

記事「Media Foundation入門 - COM視点でAPIを理解する」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

この記事は、Media FoundationがCOMを土台にしたメディア処理プラットフォームであることを、初期化・オブジェクト受け渡し・設定・列挙・非同期処理という5つの地点から説明している。COMライブラリの初期化(CoInitializeEx)はMedia Foundation自身の初期化(MFStartup)の前提になり、IMFSourceReaderやIMFAttributes、IMFTransformといった部品はいずれもIUnknownを基底に持つCOMインターフェースとしてHRESULTを返す。IMFActivateは実体を後で作るための入口で、MFTEnumExの列挙結果からActivateObjectを呼んで初めてIMFTransformが得られる。非同期処理はMTAで動くwork queueのスレッドから呼ばれるため、STA側のUIオブジェクトを直接扱わずに結果だけを橋渡しする設計が必要になる。

flowchart LR
    accTitle: Media FoundationとCOMの関係の知識マップ
    accDescr: Media FoundationがCOMを基盤にしたメディア処理プラットフォームであること、初期化・オブジェクト表現・設定・列挙・非同期処理の各地点でCOMの性質が現れること、MTAのwork queueとUIのapartmentモデルを橋渡しする必要があることを示す図
    media_foundation["Media Foundation"]
    com["COM(コンポーネントオブジェクトモデル)"]
    mfstartup["MFStartup"]
    coinitializeex["CoInitializeEx"]
    iunknown["IUnknown"]
    hresult["HRESULT"]
    imfsourcereader["IMFSourceReader(Source Reader)"]
    imftransform["IMFTransform(MFT)"]
    imfattributes["IMFAttributes"]
    imfactivate["IMFActivate(Activation Object)"]
    imfsinkwriter["IMFSinkWriter(Sink Writer)"]
    media_session["Media Session"]
    mf_topology["Topology(トポロジー)"]
    imfsourcereadercallback["IMFSourceReaderCallback"]
    mf_work_queue["work queue"]
    com_apartment_model["COMアパートメントモデル(STA/MTA)"]
    com_smart_pointer["COMスマートポインタ(ComPtr/wil::com_ptr)"]
    media_type_negotiation["メディアタイプの取り決め(media type negotiation)"]
    media_foundation -->|"利用する"| com
    mfstartup -->|"前提とする"| coinitializeex
    media_foundation -->|"利用する"| mfstartup
    com -->|"前提とする"| iunknown
    com -->|"利用する"| hresult
    imfsourcereader -->|"利用する"| com
    imftransform -->|"利用する"| com
    imfattributes -->|"利用する"| com
    imfactivate -->|"利用する"| imfattributes
    media_foundation -.->|"利用する"| imfsourcereader
    media_foundation -.->|"利用する"| imfsinkwriter
    media_foundation -.->|"利用する"| media_session
    media_session -->|"利用する"| mf_topology
    imfsourcereader -->|"利用する"| imftransform
    imfsourcereader -.->|"利用する"| imfsourcereadercallback
    imfsourcereadercallback -->|"利用する"| mf_work_queue
    mf_work_queue -->|"利用する"| com_apartment_model
    com_smart_pointer -->|"推奨される対応"| com
    imfsourcereader -->|"前提とする"| media_type_negotiation
    media_type_negotiation -->|"利用する"| imfattributes
    imftransform -.->|"前提とする"| imfactivate

概念間の関係(全21件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

Media FoundationはCOM(コンポーネントオブジェクトモデル)を利用します。Media Foundationはsource/transform/sink/activation/attributes/callbackなど部品間の境界をCOMインターフェースで表現している / 確度: 確立した関係 / 確認日: 2026-08-01 出典
MFStartupはCoInitializeExを前提とします。MFStartupを呼ぶ前に、CoInitializeExでCOMライブラリを初期化しておく必要がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Media FoundationはMFStartupを利用します。Media Foundationプラットフォーム自体の初期化はMFStartupが担う / 確度: 確立した関係 / 確認日: 2026-08-01 出典
COM(コンポーネントオブジェクトモデル)はIUnknownを前提とします。COMのすべてのインターフェースは共通の基底であるIUnknownの実装を前提とする / 確度: 確立した関係 / 確認日: 2026-08-01 出典
COM(コンポーネントオブジェクトモデル)はHRESULTを利用します。COMのメソッド呼び出しは成否をHRESULTという戻り値の型で表す / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFSourceReader(Source Reader)はCOM(コンポーネントオブジェクトモデル)を利用します。IMFSourceReaderはCOMインターフェースとして定義され、戻り値や設定オブジェクトの受け渡しにCOMの作法が使われる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFTransform(MFT)はCOM(コンポーネントオブジェクトモデル)を利用します。MFT(IMFTransform)もCOMインターフェースとして定義される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFAttributesはCOM(コンポーネントオブジェクトモデル)を利用します。IMFAttributesはGUIDをキーにした設定・型情報をCOMインターフェース越しに保持する / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFActivate(Activation Object)はIMFAttributesを利用します。IMFActivate自体もattributesを持てるため、実体化する前に候補の属性を確認できる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
Media FoundationはIMFSourceReader(Source Reader)を利用します。アプリがデータを直接扱うモデルでは、Source Readerがsourceからframe/sampleを取り出す入口になる / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Media FoundationはIMFSinkWriter(Sink Writer)を利用します。アプリがデータを直接扱うモデルでは、生成した音声・映像をファイルへ書き出す出口としてSink Writerを提供する / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Media FoundationはMedia Sessionを利用します。パイプライン全体を使うモデルでは、再生・停止・シークやA/V同期をMedia Sessionが管理する / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
Media SessionはTopology(トポロジー)を利用します。Media Sessionは、partial topologyをtopology loaderが解決したfull topologyに沿ってsource/transform/sinkをつなぐ / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFSourceReader(Source Reader)はIMFTransform(MFT)を利用します。Source Readerは必要に応じてdecoderとなるMFTを自動的に読み込んでアプリへデータを渡す / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFSourceReader(Source Reader)はIMFSourceReaderCallbackを利用します。Source Readerを非同期モードで作成すると、結果はIMFSourceReaderCallbackで受け取る / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典
IMFSourceReaderCallbackはwork queueを利用します。非同期コールバックはMedia Foundationのwork queueのスレッドから呼ばれる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
work queueはCOMアパートメントモデル(STA/MTA)を利用します。work queueのスレッドはMTAで動くため、callback側でSTAのUIオブジェクトを直接触らず、結果だけをUIスレッドへ橋渡しする設計が必要になる / 確度: 確立した関係 / 確認日: 2026-08-01 出典
COMスマートポインタ(ComPtr/wil::com_ptr)はCOM(コンポーネントオブジェクトモデル)に対する本記事の推奨です。新規にCOMインターフェースを扱うC++コードでは、生ポインタでのAddRef/Release管理よりComPtrやwil::com_ptrのようなスマートポインタが推奨される / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFSourceReader(Source Reader)はメディアタイプの取り決め(media type negotiation)を前提とします。Source Readerで狙った形式のサンプルを得るには、ネイティブタイプの列挙・major type確認・SetCurrentMediaType・GetCurrentMediaTypeという手順でメディアタイプを取り決める必要がある / 確度: 確立した関係 / 確認日: 2026-08-01 出典
メディアタイプの取り決め(media type negotiation)はIMFAttributesを利用します。メディアタイプの取り決めは、IMFAttributesを継承した属性ストアであるIMFMediaTypeを介して行う / 確度: 確立した関係 / 確認日: 2026-08-01 出典
IMFTransform(MFT)はIMFActivate(Activation Object)を前提とします。MFTEnumExで列挙してMFTを取得する経路では、結果はIMFActivateの配列として返り、必要なものだけActivateObjectで実体化して初めてIMFTransformが得られる(自作のcustom MFTを直接インスタンス化する場合はIMFActivateを経由しない) / 確度: 条件付きの関係 / 確認日: 2026-08-01 出典

主要概念の定義

Media Foundation: Windowsが提供する、メディアの再生・変換・エンコード/デコードを行うためのCOMベースのフレームワーク。
COM(コンポーネントオブジェクトモデル): 公開インターフェース、レジストリ登録、Apartment Modelなどを土台にした、Windowsのバイナリ互換コンポーネントモデル。
MFStartup: Media Foundationプラットフォーム自体を初期化するAPIで、CoInitializeExによるCOM初期化とは別に呼ぶ必要がある。
IMFSourceReader(Source Reader): Media Foundationが提供する、メディアファイルからサンプルを同期的または非同期的に読み出すための入口となるインターフェイス。
IMFTransform(MFT): デコーダー・エンコーダー・映像変換器などをパイプラインへ差し込むための共通モデルを表すMedia FoundationのCOMインターフェース。
IMFAttributes: GUIDをキーにしたkey/valueストアを表すMedia FoundationのCOMインターフェースで、設定値やメディア形式の情報を保持する。
IMFActivate(Activation Object): 列挙されたオブジェクトの本体を後で作るためのヘルパーオブジェクトを表すMedia FoundationのCOMインターフェース。
Media Session: topologyに沿ってsource・transform・sinkのデータフローや再生・停止・シーク・A/V同期をプラットフォーム側で管理するMedia Foundationの仕組み。
IMFSourceReaderCallback: Source Readerを非同期モードで使うときに実装するコールバックインターフェースで、ReadSampleの完了時にwork queueのスレッドから呼ばれる。
work queue: Media Foundationが非同期処理を実行するために持つスレッドの仕組みで、そのスレッドはMTA(Multi-Threaded Apartment)で動く。
COMスマートポインタ(ComPtr/wil::com_ptr): COMインターフェースポインタのAddRef/Releaseをスコープに応じて自動管理するC++のラッパー型。
メディアタイプの取り決め(media type negotiation): ネイティブタイプの列挙、major typeの確認、SetCurrentMediaTypeでの指定、GetCurrentMediaTypeでの確定値の読み直しという手順で、Source Readerとやり取りする出力形式を決める一連の処理。

機械可読データ

JSON-LD / Turtle ── この記事の知識グラフ全体
概念一覧 / 語彙(述語)の定義

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。