カテゴリのフィルター処理
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/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 カテゴリにはマップされないことに注意してください。
関連トピック
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示