| Microsoft DirectX 8.1 (C++) |
The FindFilterByName method finds a filter that was added to the filter graph with a specific name.
Syntax
HRESULT FindFilterByName(
LPCWSTR pName,
IBaseFilter **ppFilter
);
Parameters
pName
[in, string] Pointer to the name to search for.
ppFilter
[out] Address of a pointer to an IBaseFilter interface on the found filter.
Return Value
Returns one of the following values.
| Value | Description |
| S_OK | Success. |
| E_POINTER | Null pointer argument. |
| VFW_E_NOT_FOUND | No filter was found with the specified name. |
Remarks
If no filter is found, the method returns a NULL pointer in the ppFilter parameter.
The returned IBaseFilter interface has an outstanding reference count. The caller must release the interface.
See Also