Microsoft DirectX 8.1 (C++)

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.)

See Also