IDistributorNotify::NotifyGraphChange

  • Article
 
Microsoft DirectShow 9.0

IDistributorNotify::NotifyGraphChange

The NotifyGraphChange method is called when the set of filters in the filter graph changes or any pin connections change.

Syntax

  HRESULT NotifyGraphChange(void);

Parameters

This methods takes no parameters.

Return Values

Returns an HRESULT value.

Remarks

This method is called whenever the IFilterGraph::AddFilter, IFilterGraph::RemoveFilter, or IFilterGraph::ConnectDirect method is called or a method is called that will lead to one of these being called (such as IGraphBuilder::RenderFile).

Make sure you call Release on any held filters that have been removed at this point. For performance reasons, PIDs might choose not to rescan the filters until the PIDs actually need the interfaces, because there might be several separate notifications sent. However, it is important to release any cached interfaces immediately.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also