知識マップ: WinRTはCOMである ── IInspectable・.winmd・言語プロジェクション、そしてWinUIが今もバイナリ契約の上に乗っている理由

記事「WinRTはCOMである ── IInspectable・.winmd・言語プロジェクション、そしてWinUIが今もバイナリ契約の上に乗っている理由」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

WinRT(Windows Runtime)はマネージドランタイムではなく、COMを土台にしたABIにメタデータ(.winmd)と言語プロジェクションを足したものです。すべてのWinRTインターフェースはIInspectableを要求し、IInspectableはIUnknownを要求します。QueryInterface・AddRef・Releaseは今もすべての呼び出しの土台であり、IInspectableが追加するのはGetIids・GetRuntimeClassName・GetTrustLevelの3メソッドだけです。GetRuntimeClassNameが返す型名をメタデータで解決できることが言語プロジェクションを可能にしています。.winmdはECMA-335(CLRアセンブリと同じ)の物理形式を借りた機械可読メタデータで、システム提供のものは実行コードを含みません。C++/WinRTとC#/WinRT(CsWinRT)はこのメタデータから各言語の慣用に沿ったAPIを生成する投影であり、.NET 5で組み込みWinRTサポートが削除されて以降、C#の投影は独立したツールチェーンになりました。WinRT APIの大半はWPF・WinForms・Win32のデスクトップアプリから呼べますが、ピッカーなどCoreWindow依存のUI系クラスは表示前にIInitializeWithWindow(共有UIのDataTransferManagerは専用のIDataTransferManagerInterop)でオーナーウィンドウのHWNDを渡す必要があり、通知履歴などpackage identity必須のAPIはMSIXまたは外部の場所を指すパッケージによるパッケージ化を要求し、スレッドは事前のWinRT用初期化が必要です(ネイティブコードではRoInitializeやwinrt::init_apartmentでSTA/MTAの並行性モデルを指定し、C#のWPF/WinFormsアプリでは通常ランタイム側が処理します)。WinUIはWindows App SDKの一部として提供されるWinRT ABIの上のUIフレームワークで、既存WPF/WinForms画面へのWinUIコントロールの段階混在(XAML Islands)は世代ごとに対応と制約が異なります。

flowchart LR
    accTitle: WinRTとCOMの知識マップ
    accDescr: WinRTがCOMを前提としIInspectableと.winmdを利用する構造、すべてのWinRTインターフェースが要求するIInspectableがIUnknownを前提とすること、.winmdがECMA-335形式を利用し言語プロジェクションがそれを読むこと、C++/WinRTとC#/WinRTが言語プロジェクションの実装を担い、C#/WinRTが.NET組み込みWinRTサポートの後継であること、WinUIがWindows App SDKとWinRTを前提とすること、CoreWindow依存のWinRT UIがデスクトップアプリではIInitializeWithWindowなどUI固有のinteropによるHWNDの受け渡しを前提とすること、package identity必須のWinRT APIがpackage identityを前提とし、それがMSIXまたは外部の場所を指すパッケージで構成できること、RoInitializeがSTA/MTAというCOMのアパートメントモデルを利用すること、既存WPF/WinFormsへのWinUI段階移行が制約付きのXAML Islandsを利用することを示す図
    winrt["WinRT(Windows Runtime)"]
    com["COM(コンポーネントオブジェクトモデル)"]
    iinspectable["IInspectable"]
    iunknown["IUnknown"]
    winmd["Windows Metadata(.winmd)"]
    ecma_335["ECMA-335"]
    language_projection["言語プロジェクション"]
    cpp_winrt["C++/WinRT"]
    cs_winrt["C#/WinRT(CsWinRT)"]
    dotnet_builtin_winrt_support[".NET組み込みWinRTサポート"]
    winui["WinUI(Windows App SDK)"]
    windows_app_sdk["Windows App SDK"]
    core_window_dependent_ui["CoreWindow依存のWinRT UI"]
    initialize_with_window["IInitializeWithWindow"]
    hwnd["HWND(ウィンドウハンドル)"]
    data_transfer_manager_interop["IDataTransferManagerInterop"]
    package_identity_required_winrt_api["package identity必須のWinRT API"]
    package_identity["package identity"]
    msix_packaging["MSIXパッケージング(packaged)"]
    sparse_package["外部の場所を指すpackaged(sparse package)"]
    ro_initialize["RoInitialize"]
    com_apartment_model["COMアパートメントモデル(STA/MTA)"]
    gradual_winui_migration["既存WPF/WinFormsへのWinUI段階移行"]
    xaml_islands["XAML Islands"]
    winrt -->|"前提とする"| com
    winrt -->|"前提とする"| iinspectable
    iinspectable -->|"前提とする"| iunknown
    winrt -->|"利用する"| winmd
    winmd -->|"利用する"| ecma_335
    language_projection -->|"利用する"| winmd
    cpp_winrt -->|"実装を担う"| language_projection
    cs_winrt -->|"実装を担う"| language_projection
    cs_winrt -->|"の後継"| dotnet_builtin_winrt_support
    winui -->|"前提とする"| windows_app_sdk
    winui -->|"前提とする"| winrt
    core_window_dependent_ui -.->|"前提とする"| initialize_with_window
    initialize_with_window -->|"利用する"| hwnd
    core_window_dependent_ui -.->|"前提とする"| data_transfer_manager_interop
    data_transfer_manager_interop -->|"利用する"| hwnd
    package_identity_required_winrt_api -->|"前提とする"| package_identity
    package_identity -->|"で構成できる"| msix_packaging
    package_identity -->|"で構成できる"| sparse_package
    ro_initialize -->|"利用する"| com_apartment_model
    gradual_winui_migration -.->|"利用する"| xaml_islands

概念間の関係(全20件)

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

• WinRT(Windows Runtime)はCOM(コンポーネントオブジェクトモデル)を前提とします。Windows RuntimeはCOMに基づく(based on COM)。COMコンポーネントとWinRTクラスはどちらもインターフェースを通じて機能を公開し、参照カウント・QueryInterface・HRESULTというCOMの約束ごとがそのまま使われる。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• WinRT(Windows Runtime)はIInspectableを前提とします。すべてのWinRTインターフェースは暗黙にIInspectableを要求する。WinRTのオブジェクトはIUnknownの3メソッドの上にIInspectableの3メソッドを積み、その上に個々のAPIが乗る。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• IInspectableはIUnknownを前提とします。IInspectableはIUnknownを要求(継承)する。IUnknownは従来のCOMの用法どおりQueryInterface・AddRef・Releaseの3メソッドを定義し、IInspectableはGetIids・GetRuntimeClassName・GetTrustLevelを追加する。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典 出典
• WinRT(Windows Runtime)はWindows Metadata(.winmd)を利用します。WinRT APIは.winmdという機械可読メタデータファイルで記述される。Windowsはシステム提供の全WinRT APIのメタデータを同梱し、サードパーティも同形式で言語プロジェクションに参加できる。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• Windows Metadata(.winmd)はECMA-335を利用します。.winmdの物理形式はECMA-335仕様(CLRアセンブリと同じ)を使う。ただし有効なデータの組み合わせの規則はCLRアセンブリと異なり、システム提供の.winmdは実行コードを含まない純粋なメタデータである。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• 言語プロジェクションはWindows Metadata(.winmd)を利用します。言語プロジェクションは.winmdのメタデータを読んで、WinRT APIを各プログラミング言語の慣用に沿った形で公開する。GetRuntimeClassNameが返す型名をメタデータで解決できることが投影を可能にしている。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典 出典
• C++/WinRTは言語プロジェクションの実装を担います。C++/WinRTは標準C++17で実装されたヘッダーファイルベースの言語プロジェクションで、cppwinrt.exeが.winmdから投影ヘッダーを生成する。C++/CXとWRLの推奨後継である。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• C#/WinRT(CsWinRT)は言語プロジェクションの実装を担います。C#/WinRT(CsWinRT)は.NET向けの言語プロジェクションで、cswinrt.exeが.winmdを処理してC#の相互運用アセンブリを生成する。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• C#/WinRT(CsWinRT)は.NET組み込みWinRTサポートの後継に当たります。.NET 5でWinRTの組み込みサポートが.NET本体から削除され、C#の投影はランタイムから独立したCsWinRTツールチェーンに移行した。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• WinUI(Windows App SDK)はWindows App SDKを前提とします。WinUIはWindows App SDKの一部として提供される。単独では配布されず、Windows App SDKなしでWinUIを使うことはできない。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• WinUI(Windows App SDK)はWinRT(Windows Runtime)を前提とします。WinUIはWinRTのABIの上に建つUIフレームワークである。WinUIアプリの実体は、HWNDのウィンドウの上でIInspectableの契約に従うオブジェクトツリーが動くWin32アプリであり、UIフレームワークの世代交代の下でこの足元の契約は変わっていない。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典 出典
• CoreWindow依存のWinRT UIはIInitializeWithWindowを前提とします。ピッカー・ダイアログなどCoreWindow前提のWinRT UIクラスのうちIInitializeWithWindowを実装するものをデスクトップアプリで表示するには、表示前にこのインターフェースでオーナーウィンドウを設定する必要がある。設定しないと例外になるか黙って失敗する。共有UIのDataTransferManagerは専用のIDataTransferManagerInteropを使う別経路で、新しいWindows App SDKのピッカーはWindowIdを受け取る設計でこのパターンが不要。 / 確度: 条件付きの関係 / 確認日: 2026-08-29 出典 出典
• IInitializeWithWindowはHWND(ウィンドウハンドル)を利用します。IInitializeWithWindow::Initializeは、オーナーウィンドウとして使うウィンドウのハンドル(HWND)を受け取る。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• CoreWindow依存のWinRT UIはIDataTransferManagerInteropを前提とします。共有UIのDataTransferManagerはIInitializeWithWindowを実装せず、デスクトップアプリからの表示には専用のIDataTransferManagerInteropでオーナーウィンドウ(HWND)を渡してShowShareUIForWindowを呼ぶ必要がある。 / 確度: 条件付きの関係 / 確認日: 2026-08-29 出典
• IDataTransferManagerInteropはHWND(ウィンドウハンドル)を利用します。IDataTransferManagerInteropは、共有UIのオーナーウィンドウとして使うウィンドウのハンドル(HWND)を受け取る(ShowShareUIForWindow)。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• package identity必須のWinRT APIはpackage identityを前提とします。通知履歴・ジャンプリストなど一部のWinRT APIは、実行時にpackage identityを持つ(パッケージ化された)アプリでのみ動作する。unpackagedなアプリから呼ぶと失敗する。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• package identityはMSIXパッケージング(packaged)で構成できます。MSIXでパッケージ化して配布したアプリは実行時にpackage identityを持つ。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• package identityは外部の場所を指すpackaged(sparse package)で構成できます。既存インストーラーを維持したまま、外部の場所を指すパッケージ(packaged with external location、いわゆるsparse package)で識別子だけを付与してpackage identityを得ることもできる。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典
• RoInitializeはCOMアパートメントモデル(STA/MTA)を利用します。RoInitializeはスレッドをWinRT用に初期化する際にSTA/MTAという並行性モデルを指定する。CoInitializeのドキュメントもWinRT利用時はRoInitializeを呼ぶよう案内しており、COMのアパートメントの考え方がWinRTでもそのまま使われている。 / 確度: 確立した関係 / 確認日: 2026-08-29 出典 出典
• 既存WPF/WinFormsへのWinUI段階移行はXAML Islandsを利用します。既存WPF/WinForms画面へWinUI系コントロールを部分混在させる段階移行はXAML Islandsを使う。ただし世代の区別が必要で、UWP世代のIslandsはWPF/WinForms対応が.NET Core 3.x世代に限定され、WinUI 3世代はWindows App SDKのXAMLホスティングAPI(DesktopWindowXamlSource)としてWPF・WinForms・Win32から使えるが、ラッパーコントロールが無く実装負担が大きい。 / 確度: 条件付きの関係 / 確認日: 2026-08-29 出典 出典

主要概念の定義

WinRT(Windows Runtime)

Windows 8で導入された、COMを土台にしたストアアプリ向けの新しいAPI基盤。

IInspectable

すべてのWinRTクラスが実装する基底インターフェース。IUnknownを継承し、GetIids・GetRuntimeClassName・GetTrustLevelの3メソッドを追加する。

Windows Metadata(.winmd)

WinRT APIを記述する機械可読メタデータファイル。ツールと言語プロジェクションがこれを読んで投影を生成する。

言語プロジェクション

WinRT APIを特定のプログラミング言語の慣用に沿って公開する仕組み。COMの詳細を隠し、その言語にとって自然なプログラミング体験を提供する。

C++/WinRT

標準C++17で実装されたヘッダーファイルベースのWinRT言語プロジェクション。cppwinrt.exeが.winmdから投影ヘッダーを生成する。

C#/WinRT(CsWinRT)

.NET向けのWinRT言語プロジェクション。cswinrt.exeが.winmdを処理してC#の相互運用アセンブリを生成する。

WinUI(Windows App SDK)

Windows App SDKベースのUIフレームワーク。Windows 11のモダンなUIに沿った外観と、Microsoft Store/MSIXとの親和性を持つ。動作対象はWindows 10 バージョン1809(ビルド17763)以降で、Windows 11専用ではない。

CoreWindow依存のWinRT UI

ピッカーやダイアログなど、表示にUWPのCoreWindowを前提とするWinRTクラス群。デスクトップアプリでは追加の相互運用が必要になる。

IInitializeWithWindow

デスクトップアプリで使われるWinRTオブジェクトにオーナーウィンドウ(HWND)を渡すためのCOMインターフェース。

IDataTransferManagerInterop

共有UI(DataTransferManager)にオーナーウィンドウ(HWND)を渡してShowShareUIForWindowを呼ぶための専用COMインターフェース。IInitializeWithWindowと同じ役割を担う別経路。

package identity必須のWinRT API

通知履歴やジャンプリストなど、package identityを持つパッケージ化されたアプリでのみ動作するWinRT API群。

package identity

MSIXなどのパッケージが持つ、Windowsが認識する一意の識別子。名前、バージョン、アーキテクチャ、ResourceId、発行元という5つの組で構成される。

RoInitialize

現在のスレッドを指定した並行性モデル(STA/MTA)でWinRT用に初期化するAPI。

既存WPF/WinFormsへのWinUI段階移行

既存のWPF/WinFormsアプリに、XAML IslandsなどでWinUI系のコントロールを少しずつ混ぜていく移行構想。

機械可読データ

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

このデータセットについて

作成

合同会社小村ソフト

ライセンス

CC BY 4.0 ── 出典(合同会社小村ソフト)とライセンスへのリンクを明示し、改変した場合はその旨を示すことを条件に、再配布・改変を含めて再利用できます

最終確認日

2026-08-29 ── 収録する関係のうち、最後に出典と照合した日

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