CBaseFilter::JoinFilterGraph
A version of this page is also available for
4/8/2010
Notifies a filter that it has joined a filter graph.
Syntax
HRESULT JoinFilterGraph(
IFilterGraph* pGraph,
LPCWSTR pName
);
Parameters
- pGraph
Pointer to the filter graph to join.
- pName
[in, string] Name of the filter being added.
Return Value
None.
Remarks
This member function implements the IBaseFilter::JoinFilterGraph method.
It assigns the pGraph filter graph pointer to the m_pGraph data member and obtains the IMediaEventSink interface from the filter graph manager to allow the filter to post event notifications to the filter graph manager.
The filter should store the IMediaEventSink interface for later use, because it might need to notify the interface about events, but it should not increase the reference count on the filter graph manager object.
A null pointer indicates that the filter is no longer part of a graph.
Requirements
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment |