次の方法で共有

カテゴリをフィルター処理する

  • [アーティクル]

[このページに関連付けられている機能である DirectShow はレガシ機能です。 これは、MediaPlayer、IMFMediaEngine、メディア ファンデーションの Audio/Video Capture に置き換えられました。 これらの機能は、Windows 10 および Windows 11 用に最適化されています。 新しいコードでは、可能な場合は、DirectShow ではなく、MediaPlayer、IMFMediaEngine、メディア ファンデーションの Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存コードを、新しい API を使用するように可能であれば書き直すことを提案しています。]

次の表に、DirectShow フィルター カテゴリの CLSID を示します。

DirectShow フィルター カテゴリ

ここに示すカテゴリは、Filter Mapper によって列挙されます。 ただし、既定では、Filter Mapper はメリットが MERIT_DO_NOT_USE 以下のカテゴリを無視します。 詳細については、「IFilterMapper2::EnumMatchingFilters」を参照してください。 ここに記載されているすべてのカテゴリは、System Device Enumerator を使用して列挙することもできます。

Uuids.h では、次のカテゴリが宣言されています。 ヘッダー ファイル Dshow.h を含めます。

フレンドリ名 CLSID メリット
オーディオ キャプチャ ソース CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
オーディオ コンプレッサー CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
オーディオ レンダラー CLSID_AudioRendererCategory MERIT_NORMAL
デバイス コントロール フィルター CLSID_DeviceControlCategory MERIT_DO_NOT_USE
DirectShow フィルター CLSID_LegacyAmFilterCategory MERIT_NORMAL
外部レンダラー CLSID_TransmitCategory MERIT_DO_NOT_USE
Midi レンダラー CLSID_MidiRendererCategory MERIT_NORMAL
ビデオ キャプチャ ソース CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
ビデオ コンプレッサー CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
WDM ストリーム展開デバイス CLSID_DVDHWDecodersCategory 注: このカテゴリには、ハードウェア DVD デコーダーが含まれています。
 MERIT_DO_NOT_USE
WDM ストリーミング キャプチャ デバイス AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
WDM ストリーミング クロスバー デバイス AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
WDM ストリーミング レンダリング デバイス AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
WDM ストリーミング ティー/スプリッター デバイス AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
WDM ストリーミング テレビ オーディオ デバイス AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
WDM ストリーミング テレビ のチューナ デバイス AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
WDM ストリーミング VBI コーデック AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE

次のカテゴリは、ヘッダー ファイル Ks.h で宣言されています。

フレンドリ名 CLSID メリット
WDM ストリーミング コミュニケーション変換 KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
WDM ストリーミング データ変換 KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
WDM ストリーミング インターフェイス変換 KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
WDM ストリーミング ミキサー デバイス KSCATEGORY_MIXER MERIT_DO_NOT_USE

次のカテゴリは、ヘッダー ファイル Bdamedia.h で宣言されています。 ヘッダー ファイル ks.h、ksmedia.h、および bdamedia.h を含めます。

フレンドリ名 CLSID メリット
BDA ネットワーク プロバイダー KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
BDA レシーバー コンポーネント KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
BDA レンダリング フィルター KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
BDA ソース フィルター KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
BDA トランスポート情報レンダラー KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Note

デコーダーは、「DirectShow フィルター」カテゴリ (CLSID_LegacyAmFilterCategory) に登録されます。

その他のフィルター カテゴリ

ここで示すカテゴリは、システム デバイス列挙子で列挙できますが、フィルター マッパーには表示されず、Intelligent Connect では使用されません。

次のカテゴリは、ヘッダー ファイル Qedit.h で宣言されています。

フレンドリ名 CLID メリット
ビデオ効果 (1 入力) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
ビデオ効果 (2 入力) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

これらのカテゴリには、DirectShow Editing Services のビデオ効果と切り替えが含まれます。

  • 「ビデオ効果 (1 入力)」には、ビデオ効果が含まれています。
  • 「ビデオ効果 (2 入力)」には、ビデオの切り替えが含まれています。

詳細については、「効果と画面切り替えの解除」を参照してください。

次のカテゴリは、ヘッダー ファイル Uuids.h で宣言されています。 ヘッダー ファイル Dshow.h を含めます。

フレンドリ名 CLID メリット
EncAPI エンコーダー CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
EncAPI マルチプレクサー CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

DirectShow フィルター メタカテゴリ

フレンドリ名 CLSID メリット
ActiveMovie フィルター カテゴリ CLSID_ActiveMovieCategories 適用なし

このメタ カテゴリには、フィルター カテゴリの一覧が含まれています。 フィルター カテゴリがこのリスト内に表示されない場合、Filter Mapper はカテゴリを無視します。つまり、フィルターは Intelligent Connect では使用できません。

フィルター カテゴリの一覧を列挙するには、ICreateDevEnum::CreateClassEnumerator 値を CLSID_ActiveMovieCategories を使用して呼び出します。 このメソッドによって返されるモニカーは、次のプロパティをサポートします。

プロパティ名 説明
「FriendlyName」 カテゴリ名 (VT_BSTR)。
「メリット」 カテゴリのメリット (VT_I4)。 このプロパティがない場合は、MERIT_DO_NOT_USE として扱います。
「CLSID」 カテゴリ CLSID (VT_BSTR)。

このリストに新しいフィルター カテゴリを追加するには、IFilterMapper2::CreateCategory を呼び出します。

DMO カテゴリ

DirectX メディア オブジェクト (DNO) は、DirectShow フィルターとは異なる列挙メカニズムを使用します。 詳細については、「DMO の登録」を参照してください。 ただし、システム デバイス列挙子を使用して DMO カテゴリを列挙できます。 モニカーは DMO ラッパー フィルターにバインドし、DMO を使用してフィルターを自動的に初期化します。

さらに、DMO カテゴリの一部は、インテリジェント接続の目的で DirectShow フィルター カテゴリにマップされます。

DMO カテゴリ DirectShow の同等の機能
DMOCATEGORY_AUDIO_ENCODER CLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODER CLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODER CLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODER CLSID_LegacyAmFilterCategory

ビデオ効果とオーディオ効果のカテゴリは、DirectShow カテゴリにマップされないことに注意してください。

定数と GUID

デバイスとフィルターの列挙

インテリジェント接続

レジストリ キーのレイアウト

フィルター マッパーの使用

システム デバイス列挙子の使用