 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Finds a filter that was added to the filter graph with a specific name.
HRESULT FindFilterByName( LPCWSTR pName , IBaseFilter ** ppFilter );
Parameters
- pName
- [in, string] Name to search for.
- ppFilter
- [out] Pointer to an
IBaseFilterinterface
on the found filter.
Return Values
Returns an HRESULTvalue that depends on the implementation. HRESULTcan be one of the following standard constants, or other values not listed.
E_FAIL Failure. E_POINTER Null pointer argument. E_INVALIDARG Invalid argument. E_NOTIMPL Method isn't supported. S_OK or NOERROR Success. Remarks
This function fails and sets pointers to the ppFilterparameter to NULL if the name is not in this graph.