IMediaEvent 接口 (control.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
接口 IMediaEvent 包含用于检索事件通知和替代 Filter Graph 管理器对事件的默认处理的方法。 IMediaEventEx 接口继承并扩展此接口。
筛选器关系图管理器实现此接口。 应用程序可以使用它来响应筛选器图中发生的事件，例如流的结尾或呈现错误。 使用 IMediaEventSink 接口筛选将事件发布到筛选器图。
有关事件通知的详细信息，请参阅 DirectShow 中的事件通知。 有关系统定义的事件通知的列表，请参阅 事件通知代码。
继承
IMediaEvent 接口继承自 IDispatch 接口。 IMediaEvent 还具有以下类型的成员：
方法
IMediaEvent 接口包含以下方法。
| IMediaEvent：：CancelDefaultHandling CancelDefaultHandling 方法取消筛选器关系图管理器对指定事件的默认处理。 事件通知将传递给应用程序。 |
| IMediaEvent：：FreeEventParams FreeEventParams 方法释放与事件参数关联的资源。 |
| IMediaEvent：：GetEvent GetEvent 方法从事件队列中检索下一个事件通知。 |
| IMediaEvent：：GetEventHandle GetEventHandle 方法检索在队列包含事件通知时保持信号的手动重置事件的句柄。 |
| IMediaEvent：：RestoreDefaultHandling RestoreDefaultHandling 方法还原筛选器关系图管理器对指定事件的默认处理。 |
| IMediaEvent：：WaitForCompletion WaitForCompletion 方法等待筛选器图呈现所有可用数据。 筛选器图必须正在运行，否则方法将失败。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | control.h (包括 Dshow.h) |