Фильтрация категорий

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

В следующих таблицах перечислены идентификаторы CLSID для категорий фильтров DirectShow.

Категории фильтра 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 Streaming TV AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
Устройства потокового ТВ-тюнера WDM AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
Кодеки VBI потоковой передачи WDM 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 Mixer 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:

  • "Видеоэффекты (1 вход)" содержит видеоэффекты.
  • "Видеоэффекты (2 входных данных)" содержит переходы видео.

Дополнительные сведения см. в разделе Перечисление эффектов и переходов.

Следующие категории объявляются в файле заголовка Uuids.h. Включите файл заголовка Dshow.h.

Понятное имя CLID Заслуга
Кодировщики EncAPI CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Мультиплексоры EncAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

Meta-Category фильтра DirectShow

Понятное имя CLSID Заслуга
Категории фильтра ActiveMovie CLSID_ActiveMovieCategories Неприменимо

Эта метакатегория содержит список категорий фильтров. Если категория фильтра не отображается в этом списке, средство сопоставления фильтров игнорирует эту категорию, что означает, что фильтр недоступен для Intelligent Connect.

Чтобы перечислить список категорий фильтров, вызовите метод ICreateDevEnum::CreateClassEnumerator со значением CLSID_ActiveMovieCategories. Моникеры, возвращаемые этим методом, поддерживают следующие свойства.

Имя свойства Описание
"FriendlyName" Имя категории (VT_BSTR).
"Заслуга" Категория заслуг (VT_I4). Если это свойство отсутствует, рассматривайте как MERIT_DO_NOT_USE.
"CLSID" ClSID категории (VT_BSTR).

Чтобы добавить в этот список новую категорию фильтра, вызовите IFilterMapper2::CreateCategory.

Категории DMO

Объекты мультимедиа DirectX используют механизм перечисления, отличный от фильтров 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

Перечисление устройств и фильтров

Intelligent Connect

Макет разделов реестра

Использование модуля сопоставления фильтров

Использование перечислителя системных устройств