EC_NEED_RESTART

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

筛选器正在请求重启图形。

参数

lParam1

Zero。

lParam2

Zero。

默认操作

筛选器图管理器暂停并重启图形。 它不会将事件传递给应用程序。

备注

如果筛选器拒绝流中间的样本,上游引脚将停止提供样本。 筛选器可以通过发送此事件来重启流。 例如,音频呈现器可能无法访问声音设备,因为视频窗口已失去焦点。 此时,音频呈现器开始拒绝样本。 当它重新获得对声音设备的访问权限时,它会发送此事件以重启音频流。

要求

要求
标头
Dshow.h

另请参阅

事件通知代码

DirectShow 中的事件通知