EC_COMPLETE

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 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 中的事件通知

备用视频呈现器