|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.
|Zero||No flags set.|
|AM_FILTER_FLAGS_REMOVABLE||The filter is removable during a dynamic reconnection. For more information, see Remarks.|
Returns one of the following HRESULT values.
|E_POINTER||Null pointer argument.|
|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.