IGraphConfig::RemoveFilterEx

 
Microsoft DirectShow 9.0

IGraphConfig::RemoveFilterEx

The RemoveFilterEx method removes a filter from the filter graph.

Syntax

  HRESULT RemoveFilterEx(
  IBaseFilter *pFilter,
  DWORD Flags
);

Parameters

pFilter

[in] Pointer to the filter to remove from the graph.

Flags

[in] Combination of flags from the REM_FILTER_FLAGS enumerated type.

Return Values

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

Remarks

This method extends the IFilterGraph::RemoveFilter method by accepting a flag that specifies the behavior of the method. This flag enables an application to remove a filter without disconnecting the pins automatically, which improves performance when moving groups of connected filters into a new graph.

By default, this method disconnects the filter before removing it from the graph. Use the REMFILTERF_LEAVECONNECTED flag to leave the filter connected.

Requirements

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

Library: Use Strmiids.lib.

See Also