|Microsoft DirectX 9.0|
The RemoveFilterEx method removes a filter from the filter graph.
HRESULT RemoveFilterEx( IBaseFilter *pFilter, DWORD Flags );
[in] Pointer to the filter to remove from the graph.
[in] Combination of flags from the REM_FILTER_FLAGS enumerated type.
Returns S_OK if successful, or an HRESULT value indicating the cause of the failure.
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.