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 指针。 如果启用默认操作,筛选器图管理器会将此参数设置为零。
要求
要求 | 值 |
---|---|
标头 |
|