UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:strmif.IFilterGraph.FindFilterByName |
IFilterGraph::FindFilterByName (strmif.h) |
The FindFilterByName method finds a filter that was added to the filter graph with a specific name. |
|
dshow\ifiltergraph_findfilterbyname.htm |
dshow |
59d90274-ac00-4e19-bcee-2282e26994b5 |
4/26/2023 |
FindFilterByName, FindFilterByName method [DirectShow], FindFilterByName method [DirectShow],IFilterGraph interface, IFilterGraph interface [DirectShow],FindFilterByName method, IFilterGraph.FindFilterByName, IFilterGraph::FindFilterByName, IFilterGraphFindFilterByName, dshow.ifiltergraph_findfilterbyname, strmif/IFilterGraph::FindFilterByName |
strmif.h |
Dshow.h |
Windows |
Windows 2000 Professional [desktop apps only] |
Windows 2000 Server [desktop apps only] |
Strmiids.lib |
Windows |
19H1 |
|
|
|
|
|
|
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The FindFilterByName
method finds a filter that was added to the filter graph with a specific name.
[in, string] Pointer to the name to search for.
Receives a pointer to the filter's IBaseFilter interface. The caller must release the interface.
Returns one of the following values.
Return code | Description |
---|---|
|
Success. |
|
NULL pointer argument. |
|
No filter was found with the specified name. |
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.