Export (0) Print
Expand All

Filter Categories

The following tables list the CLSIDs for the DirectShow filter categories.

DirectShow Filter Categories

The categories listed here are enumerated by the Filter Mapper. By default, however, the Filter Mapper ignores categories with merits of MERIT_DO_NOT_USE or less. For more information, see IFilterMapper2::EnumMatchingFilters. All of the categories listed here can also be enumerated with the System Device Enumerator.

The following categories are declared in Uuids.h. Include the header file Dshow.h.

Friendly Name CLSID Merit
Audio Capture SourcesCLSID_AudioInputDeviceCategoryMERIT_DO_NOT_USE
Audio CompressorsCLSID_AudioCompressorCategoryMERIT_DO_NOT_USE
Audio RenderersCLSID_AudioRendererCategoryMERIT_NORMAL
Device Control FiltersCLSID_DeviceControlCategoryMERIT_DO_NOT_USE
DirectShow FiltersCLSID_LegacyAmFilterCategoryMERIT_NORMAL
External RenderersCLSID_TransmitCategoryMERIT_DO_NOT_USE
Midi RenderersCLSID_MidiRendererCategoryMERIT_NORMAL
Video Capture SourcesCLSID_VideoInputDeviceCategoryMERIT_DO_NOT_USE
Video CompressorsCLSID_VideoCompressorCategoryMERIT_DO_NOT_USE
WDM Stream Decompression DevicesCLSID_DVDHWDecodersCategory

Note  This category contains hardware DVD decoders.

MERIT_DO_NOT_USE
WDM Streaming Capture DevicesAM_KSCATEGORY_CAPTUREMERIT_DO_NOT_USE
WDM Streaming Crossbar DevicesAM_KSCATEGORY_CROSSBARMERIT_DO_NOT_USE
WDM Streaming Rendering DevicesAM_KSCATEGORY_RENDERMERIT_DO_NOT_USE
WDM Streaming Tee/Splitter DevicesAM_KSCATEGORY_SPLITTERMERIT_DO_NOT_USE
WDM Streaming TV Audio DevicesAM_KSCATEGORY_TVAUDIOMERIT_DO_NOT_USE
WDM Streaming TV Tuner DevicesAM_KSCATEGORY_TVTUNERMERIT_DO_NOT_USE
WDM Streaming VBI CodecsAM_KSCATEGORY_VBICODECMERIT_DO_NOT_USE

 

The following categories are declared in the header file Ks.h.

Friendly Name CLSID Merit
WDM Streaming Communication TransformsKSCATEGORY_COMMUNICATIONSTRANSFORMMERIT_DO_NOT_USE
WDM Streaming Data TransformsKSCATEGORY_DATATRANSFORMMERIT_DO_NOT_USE
WDM Streaming Interface TransformsKSCATEGORY_INTERFACETRANSFORMMERIT_DO_NOT_USE
WDM Streaming Mixer DevicesKSCATEGORY_MIXERMERIT_DO_NOT_USE

 

The following categories are declared in the header file Bdamedia.h. Include the following header files: ks.h, ksmedia.h, and bdamedia.h.

Friendly Name CLSID Merit
BDA Network ProvidersKSCATEGORY_BDA_NETWORK_PROVIDERMERIT_NORMAL
BDA Receiver ComponentsKSCATEGORY_BDA_RECEIVER_COMPONENTMERIT_DO_NOT_USE
BDA Rendering FiltersKSCATEGORY_IP_SINKMERIT_DO_NOT_USE
BDA Source FiltersKSCATEGORY_BDA_NETWORK_TUNERMERIT_DO_NOT_USE
BDA Transport Information RenderersKSCATEGORY_BDA_TRANSPORT_INFORMATIONMERIT_NORMAL

 

Note  Decoders are registered under the "DirectShow Filters" category (CLSID_LegacyAmFilterCategory).

Other Filter Categories

The categories listed here can be enumerated with the System Device Enumerator, but are not visible to the Filter Mapper and are not used by Intelligent Connect.

The following categories are declared in the header file Qedit.h.

Friendly Name CLID Merit
Video Effects (1 input)CLSID_VideoEffects1CategoryMERIT_DO_NOT_USE
Video Effects (2 inputs)CLSID_VideoEffects2CategoryMERIT_DO_NOT_USE

 

These categories contain video effects and transitions for DirectShow Editing Services:

  • "Video Effects (1 input)" contains video effects.
  • "Video Effects (2 input)" contains video transitions.

For more information, see Enumerating Effects and Transitions.

The following categories are declared in the header file Uuids.h. Include the header file Dshow.h.

Friendly Name CLID Merit
EncAPI EncodersCLSID_MediaEncoderCategoryMERIT_DO_NOT_USE
EncAPI MultiplexersCLSID_MediaMultiplexerCategoryMERIT_DO_NOT_USE

 

DirectShow Filter Meta-Category

Friendly Name CLSID Merit
ActiveMovie Filter CategoriesCLSID_ActiveMovieCategoriesNot applicable

 

This meta-category contains a list of filter categories. If a filter category does not appear within this list, the Filter Mapper ignores the category, which means the filter is not available for Intelligent Connect.

To enumerate the list of filter categories, call ICreateDevEnum::CreateClassEnumerator with the value CLSID_ActiveMovieCategories. The monikers returned by this method support the following properties.

Property Name Description
"FriendlyName"Category name (VT_BSTR).
"Merit"Category merit (VT_I4). If this property is absent, treat as MERIT_DO_NOT_USE.
"CLSID"Category CLSID (VT_BSTR).

 

To add a new filter category to this list, call IFilterMapper2::CreateCategory.

DMO Categories

DirectX Media Objects (DMOs) use a different enumeration mechanism from DirectShow filters. For more information, see Registering a DMO. However, you can use the System Device Enumerator to enumerate DMO categories. The monikers bind to the DMO Wrapper Filter and automatically initialize the filter with the DMO.

In addition, some of the DMO categories are mapped to DirectShow filter categories for the purposes of intelligent connect:

DMO Category DirectShow Equivalent
DMOCATEGORY_AUDIO_ENCODERCLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODERCLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODERCLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODERCLSID_LegacyAmFilterCategory

 

Note that the video effect and audio effect categories are not mapped to any DirectShow categories.

Related topics

Constants and GUIDs
Enumerating Devices and Filters
Intelligent Connect
Layout of the Registry Keys
Using the Filter Mapper
Using the System Device Enumerator

 

 

Community Additions

ADD
Show:
© 2014 Microsoft