CBaseRenderer.SendEndOfStream 方法

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

如果已达到流结束,方法 SendEndOfStream 会为筛选器图管理器安排EC_COMPLETE事件。

语法

virtual HRESULT SendEndOfStream();

参数

此方法没有任何参数。

返回值

返回 HRESULT 值。 可能的值包括下表中的值。

返回代码 说明
S_FALSE
筛选器图管理器不接受事件通知。
S_OK
成功。

备注

筛选器可能会在当前样本的停止时间之前收到流结束通知。 如果是这样,筛选器应在将 EC_COMPLETE 通知发布到筛选器关系图管理器之前等待。

因此:

  • 如果筛选器已收到早期流结束 (EOS) 通知,此方法将计划计时器事件。 激活计时器事件时,筛选器会发布EC_COMPLETE事件。
  • 如果筛选器收到不早的 EOS 通知,此方法会立即发布EC_COMPLETE事件。
  • 如果筛选器没有任何挂起的 EOS 通知,则该方法返回时不执行任何操作。

计时器回调方法是 CBaseRenderer::TimerCallback。 若要传递 EC_COMPLETE 事件,筛选器会调用 CBaseRenderer::NotifyEndOfStream 方法。

要求

要求
标头
Renbase.h (包括 Streams.h)

Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

CBaseRenderer 类