Share via

CBaseFilter::JoinFilterGraph

  • Article

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

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 3.0 and later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.