EC_COMPLETE

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

特定流中的所有数据都已呈现。

参数

lParam1

(HRESULT) 完成时流的状态。 如果在播放过程中未发生错误,则值S_OK。

lParam2

(IUnknown*) 零,或指向呈现器 IBaseFilter 接口的指针。

默认操作

默认情况下,筛选器图管理器不会将此事件转发给应用程序。 但是,在图形报表中的所有流 EC_COMPLETE之后,筛选图管理器会将单独的 EC_COMPLETE 事件发布到应用程序。

如果对此事件禁用默认操作,应用程序将从呈现器接收所有 EC_COMPLETE 事件。

备注

呈现器筛选器在收到流结束通知时发送此事件。 (流结束通过 IPin::EndOfStream 方法发出信号。) 筛选器为每个流发送一个 EC_COMPLETE 事件。 筛选器必须在发送事件之前处理任何挂起的示例。 停止呈现器会重置缓存的任何流结束状态。

如果呈现器暂停,则在调用 IMediaFilter::Run 方法之前,它不会发送EC_COMPLETE。 此外,它会继续为从暂停到运行的每个转换发送 EC_COMPLETE 事件,直到筛选器停止或刷新。

筛选器将 lParam2 参数设置为 IBaseFilter 指针。 如果启用默认操作,筛选器图管理器会将此参数设置为零。

要求

要求
标头
Dshow.h

另请参阅

事件通知代码

DirectShow 中的事件通知

备用视频呈现器