| Microsoft DirectX 8.1 (C++) |
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 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. |
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.
See Also