 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. |
Notifies a filter that it has joined a filter graph.
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 Values
No return value.
Remarks
This member function implements the IBaseFilter::JoinFilterGraphmethod. It assigns the pGraphfilter graph pointer to the m_pGraphdata member and obtains the IMediaEventSinkinterface from the filter graph manager to allow the filter to post event notifications to the filter graph manager.
The filter should store the IMediaEventSinkinterface 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.