| Microsoft DirectX 9.0 |
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 variable that receives a pointer to the filter's IBaseFilter interface.
Return Values
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