CPullPin::OnError

  • Article
 
Microsoft DirectShow 9.0

CPullPin::OnError

The OnError method is called if an error occurs during streaming. The derived class must implement this method.

Syntax

  virtual void OnError(
    HRESULT hr
) PURE;

Parameters

hr

Specifies the HRESULT value returned by the method that failed.

Return Values

This method does not return a value.

Remarks

The object calls this method whenever an error occurs that halts the data-pulling thread. The filter can use this method to recover from streaming errors gracefully. In most cases, the error is returned from the upstream filter, so the upstream filter is responsible for reporting it to the Filter Graph Manager. If the error occurs inside the CPullPin::Receive method, your filter should send an EC_ERRORABORT event. (See IMediaEventSink::Notify.)

Requirements

**  Header:** Include Pullpin.h and Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also