IDistributorNotify 接口 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
接口 IDistributorNotify
允许插件分发服务器在筛选器图更改时收到通知。
应用程序永远不会使用此接口。 如果要 (PID) 编写插件分发服务器,并且希望 PID 接收筛选器图组合中的控件和更改通知,请实现此接口。
Filter Graph 管理器在聚合的任何插件分发服务器上查询此接口。 如果 PID 公开此接口,则 Filter Graph 管理器在调用筛选器上的等效 IBaseFilter 方法之前,通过调用 IDistributorNotify 方法,将任何状态更改通知 PID。 Filter Graph 管理器还会在添加或删除筛选器或任何引脚连接更改时调用 IDistributorNotify::NotifyGraphChange 方法。
在调用任何 IDistributorNotify 方法期间,不要保存可能由另一个调用 Filter Graph Manager 上方法的代码路径保留的关键节。 这样做可能会导致死锁。
继承
IDistributorNotify 接口继承自 IUnknown 接口。 IDistributorNotify 也具有以下类型的成员:
方法
IDistributorNotify 接口具有这些方法。
IDistributorNotify::NotifyGraphChange 当筛选器图中的筛选器集更改或任何引脚连接更改时,将调用 NotifyGraphChange 方法。 |
IDistributorNotify::P ause 当筛选器图进入暂停状态时,将调用 Pause 方法。 |
IDistributorNotify::Run 当筛选器图进入运行状态时,将调用 Run 方法。 |
IDistributorNotify::SetSyncSource 注册新时钟时,将调用 SetSyncSource 方法。 |
IDistributorNotify::Stop 当筛选器图进入停止状态时,将调用 Stop 方法。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |