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)

另请参阅

IDispatch