Microsoft DirectX 9.0


The SetFilterFlags method sets a filter's configuration information.


HRESULT SetFilterFlags(
  IBaseFilter *pFilter,
  DWORD dwFlags



[in] Pointer to a filter in the filter graph.


[in] Value specifying the new configuration flags. Must be one of the following values.

Value Description
Zero No flags set.
AM_FILTER_FLAGS_REMOVABLE The filter is removable during a dynamic reconnection. For more information, see Remarks.

Return Value

Returns one of the following HRESULT values.

Value Description
E_POINTER Null pointer argument.
E_INVALIDARG Invalid argument.
S_OK Success.
VFW_E_NOT_IN_GRAPH The filter is not in the graph.


The AM_FILTER_FLAGS_REMOVABLE flag changes the behavior of the IGraphConfig::Reconnect method. The Reconnect method performs a dynamic reconnection between two pins. If the caller specifies one pin, but leaves the other pin unspecified, Reconnect searches upstream or downstream from the specified pin to find a suitable match. By default, however, the search fails if it reaches a filter that was added to the graph by means of the IFilterGraph::AddFilter method. To override this behavior, call SetFilterFlags and set the AM_FILTER_FLAGS_REMOVABLE flag on the filter.

See Also