カテゴリのフィルター処理

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayerIMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayerIMFMediaEngineAudio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

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

DirectShow フィルター カテゴリ

ここに一覧表示されているカテゴリは 、フィルター マッパーによって列挙されます。 ただし、既定では、フィルター マッパーは、MERIT_DO_NOT_USE以下のメリットを持つカテゴリを無視します。 詳細については、「 IFilterMapper2::EnumMatchingFilters」を参照してください。 ここに記載されているすべてのカテゴリは、 システム デバイス列挙子を使用して列挙することもできます。

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 ストリーミング Tee/Splitter デバイス AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
WDM ストリーミング テレビ オーディオ デバイス AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
WDM ストリーミング TV チューナ デバイス 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

注意

デコーダーは、"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 入力)" には、ビデオ効果が含まれています。
  • "Video Effects (2 input)" には、ビデオの切り替えが含まれています。

詳細については、「 効果と遷移の列挙」を参照してください。

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

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

DirectShow フィルター Meta-Category

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

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

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

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

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

DMO カテゴリ

DirectX Media Objects (DMO) では、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

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

インテリジェント接続

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

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

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