IFilterMapper2::UnregisterFilter

This method removes the registration of the specified filter from the registry.

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

Parameters

  • pclsidCategory
    [in] Name of the category that the filter falls under.
  • szInstance
    [in] Name of the filter you want to remove.
  • Filter
    [in] Globally unique identifier (GUID) of the filter.

Return Values

Returns S_OK on success; HRESULT_FROM_WIN32 on failure.

Remarks

If szInstance is NULL, this method uses the filter GUID passed in Filter.

This method might return an error if the filter was not registered.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IFilterMapper2 Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.