CPullPin.OnError 方法

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

OnError如果在流式处理过程中发生错误,则调用 方法。 派生类必须实现此方法。

语法

virtual void OnError(
   HRESULT hr
) = 0;

参数

小时

指定失败的方法返回的 HRESULT 值。

返回值

此方法不返回值。

备注

每当发生导致数据拉取线程停止的错误时,对象将调用此方法。 筛选器可以使用此方法从流式处理错误中正常恢复。 在大多数情况下,错误是从上游筛选器返回的,因此上游筛选器负责将其报告给筛选器关系图管理器。 如果错误发生在 CPullPin::Receive 方法中,筛选器应发送 EC_ERRORABORT 事件。 (请参阅 IMediaEventSink::Notify.)

要求

要求
标头
Pullpin.h

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

另请参阅

CPullPin 类