IGraphConfig::SetFilterFlags method (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The SetFilterFlags method sets a filter's configuration information.

Syntax

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Parameters

[in] pFilter

Pointer to the IBaseFilter interface of a filter in the filter graph.

[in] dwFlags

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

Return value

Returns one of the following HRESULT values.

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

See also

Error and Success Codes

IGraphConfig Interface