CBaseFilter::Run

  • Article
 
Microsoft DirectShow 9.0

CBaseFilter::Run

The Run method runs the filter. This method implements the IMediaFilter::Run method.

Syntax

  HRESULT Run(
    REFERENCE_TIME tStart
);

Parameters

tStart

Reference time corresponding to stream time 0.

Return Value

Returns S_OK if successful, or an HRESULT value indicating the cause of the error.

Remarks

If the filter is stopped, this method pauses the filter by calling the CBaseFilter::Pause method. It then calls the CBasePin::Run method on each of the filter's connected pins. Finally, it sets the CBaseFilter::m_State member variable to State_Running.

Stream time is calculated as the current reference time minus tStart. A media sample with a time stamp of zero should be rendered at time tStart.

Requirements

**  Header:** Declared in Amfilter.h; include Streams.h.

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

See Also