Microsoft DirectX 8.1 (C++)

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 Value

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.

RemoveFilterEx

See Also