IFilterMapper2::UnregisterFilter

Microsoft DirectShow 9.0

The UnregisterFilter method removes filter information from the registry.

Syntax

  HRESULT UnregisterFilter(
  const CLSID *pclsidCategory,
  const OLECHAR *szInstance,
  REFCLSID Filter
);

Parameters

pclsidCategory

[in] Address of a GUID that specifies the filter category from which to remove the filter. For a list of categories, see Filter Categories.

szInstance

[in] Instance data used to construct the device moniker's display name. Use the value that was originally passed to the RegisterFilter method.

Filter

[in] Class identifier (CLSID) of the filter.

Return Values

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

Remarks

If the filter was not registered, the method might return an error.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also

Additional resources