Share via


IGraphConfig::SetFilterFlags

 
Microsoft DirectShow 9.0

IGraphConfig::SetFilterFlags

The SetFilterFlags method sets a filter's configuration information.

Syntax

  HRESULT SetFilterFlags(
  IBaseFilter *pFilter,
  DWORD dwFlags
);

Parameters

pFilter

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

dwFlags

[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 Values

Returns one of the following HRESULT values.

Return code 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.

Remarks

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.

Requirements

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

Library: Use Strmiids.lib.

See Also