Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

IFilterMapper2::CreateCategory method

The CreateCategory method adds a new filter category to the registry.

Syntax


HRESULT CreateCategory(
  [in] REFCLSID clsidCategory,
  [in] DWORD    dwCategoryMerit,
  [in] LPCWSTR  Description
);

Parameters

clsidCategory [in]

Class identifier (CLSID) of the new filter category.

dwCategoryMerit [in]

Merit of the category. Categories with higher merit are enumerated first.

Description [in]

Descriptive name for the category.

Return value

Returns S_OK if successful, or an HRESULT value indicating the cause of the error.

Remarks

The filter graph manager initially skips all categories with a merit value less than or equal to MERIT_DO_NOT_USE, to speed up the graph-building process. Filter categories that should not be considered for playback should have a merit of MERIT_DO_NOT_USE or less.

A filter can appear in one or more categories (for example, Video Compressors) to restrict the search space.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

Error and Success Codes
IFilterMapper2 Interface

 

 

Community Additions

ADD
Show:
© 2015 Microsoft