CBaseFilter::Run

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Transitions the filter from paused to running state if it is not in this state already.

Syntax

HRESULT Run (
  REFERENCE_TIME tStart
);

Parameters

• tStart
  Reference time value corresponding to stream time 0.

Return Value

Returns an HRESULT value. The default implementation returns NOERROR.

Remarks

If the filter is in State_Stopped state, the CBaseFilter::Pause method is called first to transition the filter to State_Paused state, which has the effect of activating any of the filter's connected pins.

If any pin returns a failure return code from its Active method, the function fails and the state is not changed.

If this member function succeeds, the filter's m_State member variable is set to State_Running.

This member function holds the filter's lock.

Requirements