Edit

IMediaControl::get_RegFilterCollection method (control.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The get_RegFilterCollection method retrieves a collection of all the filters listed in the registry.

This method is intended for use by Visual Basic 6.0 applications. It was documented for Visual Basic 6.0 as the FilgraphManager.RegFilterCollection property. C++ applications should use the IFilterMapper2::EnumMatchingFilters method instead.

Syntax

HRESULT get_RegFilterCollection(
  [out] IDispatch **ppUnk
);

Parameters

[out] ppUnk

Receives a pointer to the IDispatch interface. The caller must release the interface. You can query the returned pointer for the IAMCollection interface. The collection contains a list of IRegFilterInfo pointers.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header control.h (include Dshow.h)
Library Strmiids.lib

See also

IMediaControl Interface