Категории фильтров
[Функция, связанная с этой страницей, DirectShow — это устаревшая функция. Он был заменен MediaPlayer, МВФMediaEngine и аудио/видеозахват в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать новый код MediaPlayer, МВФMediaEngine и аудио-видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает, что существующий код, использующий устаревшие API, будет перезаписан для использования новых API, если это возможно.]
В следующих таблицах перечислены CLSID для категорий фильтров DirectShow.
- Категории фильтров DirectShow
- Другие категории фильтров
- Мета-категория фильтра DirectShow
- Категории DMO
- Связанные статьи
Категории фильтров DirectShow
Перечисленные здесь категории перечисляются фильтром Mapper. Однако по умолчанию фильтр mapper игнорирует категории с преимуществами 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 и splitter | AM_KSCATEGORY_SPLITTER | MERIT_DO_NOT_USE |
| Аудиоустройства потоковой передачи WDM | 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 | 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 |
Мета-категория фильтра DirectShow
| Понятное имя | CLSID | Заслуга |
|---|---|---|
| Категории фильтров ActiveMovie | CLSID_ActiveMovieCategories | Нет данных |
Эта мета-категория содержит список категорий фильтров. Если категория фильтра не отображается в этом списке, средство сопоставления фильтров игнорирует категорию, что означает, что фильтр недоступен для Intelligent Connect.
Чтобы перечислить список категорий фильтров, вызовите ICreateDevEnum::CreateClassEnumerator со значением CLSID_ActiveMovieCategories. Моникеры, возвращаемые этим методом, поддерживают следующие свойства.
| Имя свойства | Description |
|---|---|
| "FriendlyName" | Имя категории (VT_BSTR). |
| "Заслуга" | Заслуги категории (VT_I4). Если это свойство отсутствует, обратитесь к MERIT_DO_NOT_USE. |
| CLSID | Категория CLSID (VT_BSTR). |
Чтобы добавить в этот список новую категорию фильтров, вызовите IFilterMapper2::CreateCategory.
Категории DMO
Объекты мультимедиа DirectX (DMOS) используют другой механизм перечисления из фильтров 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.