IDistributorNotify Interface
This interface is an optional interface for use by plug-in distributors to notify them of changes in the filter graph state.
When to Implement
Implement this interface when writing a plug-in distributor (PID) that is aggregated with the filter graph manager if you want the PID to receive notifications of control and changes in the composition of filter graphs.
PIDs may often use methods on the filter graph manager. During a call to an IDistributorNotify method, do not take any lock that may be held by another code path that calls the filter graph manager. To do so could result in a deadlock.
When to Use
The filter graph manager queries for this interface on any plug-in distributors that it aggregates. If found, it calls the appropriate Run, Pause, or SetSyncSource method before calling them on the IBaseFilter interface of each filter. It calls the NotifyGraphChange method whenever a filter is added or removed, or connections are changed.
Methods in Vtable Order
The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.
| Method | Description |
|---|---|
| Stop | Called when the filter graph is entering a stopped state. |
| Pause | Called when the filter graph is entering a paused state. |
| Run | Called when the filter graph is entering a running state. |
| SetSyncSource | Called when a new clock is registered. |
| NotifyGraphChange | Called when the set of filters in the filter graph change or their connections change. |
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 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:
Last updated on Wednesday, April 13, 2005
© 2005 Microsoft Corporation. All rights reserved.