CBaseFilter::JoinFilterGraph

A version of this page is also available for

Windows Embedded CE 6.0 R3

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