AMovieSetupRegisterFilter2

AMovieSetupRegisterFilter2

The AMovieSetupRegisterFilter2 function registers a filter's merit, pins, and media types in the registry using the IFilterMapper2 interface.

Syntax

  HRESULT AMovieSetupRegisterFilter2(
    const AMOVIESETUP_FILTER const *psetupdata,
    IFilterMapper2 *pIFM2,
    BOOL bRegister
);

Parameters

psetupdata

Pointer to the AMOVIESETUP_FILTER data.

pIFM

Pointer to IFilterMapper2 interface.

bRegister

Value indicating whether to register the filter; TRUE indicates register the filter, FALSE indicates unregister it.

Return Value

Returns S_OK if the method succeeds, or an HRESULT error code.

Remarks

AMovieDllRegisterServer2 uses this helper function to register a filter after the COM server has been registered.

Typically, a filter will use AMovieDllRegisterServer2 and will not call this function directly.

Requirements

**  Header:** Declared in Dllsetup.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also

• DLL Setup Functions