IFilterGraph::FindFilterByName

  • Article
 
Microsoft DirectShow 9.0

IFilterGraph::FindFilterByName

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] Receives a pointer to the filter's IBaseFilter interface. The caller must release the 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.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also