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