Share via

CBaseFilter::JoinFilterGraph (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CBaseFilter Class