カテゴリをフィルター処理する
[このページに関連付けられている機能である 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 カテゴリにマップされないことに注意してください。