CBaseRenderer.SendEndOfStream 方法
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
如果已达到流结束,方法 SendEndOfStream
会为筛选器图管理器安排EC_COMPLETE事件。
语法
virtual HRESULT SendEndOfStream();
参数
此方法没有任何参数。
返回值
返回 HRESULT 值。 可能的值包括下表中的值。
返回代码 | 说明 |
---|---|
|
筛选器图管理器不接受事件通知。 |
|
成功。 |
备注
筛选器可能会在当前样本的停止时间之前收到流结束通知。 如果是这样,筛选器应在将 EC_COMPLETE 通知发布到筛选器关系图管理器之前等待。
因此:
- 如果筛选器已收到早期流结束 (EOS) 通知,此方法将计划计时器事件。 激活计时器事件时,筛选器会发布EC_COMPLETE事件。
- 如果筛选器收到不早的 EOS 通知,此方法会立即发布EC_COMPLETE事件。
- 如果筛选器没有任何挂起的 EOS 通知,则该方法返回时不执行任何操作。
计时器回调方法是 CBaseRenderer::TimerCallback。 若要传递 EC_COMPLETE 事件,筛选器会调用 CBaseRenderer::NotifyEndOfStream 方法。
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|