Share via


CBaseMediaFilter::Run (Windows CE 5.0)

Send Feedback

Transitions the filter to State_Running state if it is not already in this state.

HRESULT Run (REFERENCE_TIMEtStart);

Parameters

  • tStart
    Reference time value corresponding to stream time 0.

Return Values

Returns an HRESULT value.

Remarks

If the filter is in State_Stopped state, the CBaseMediaFilter::Pause member function 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 CBasePin::Active member function, 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.

Filters should derive their filters from CBaseFilter and not from CBaseMediaFilter, so filters will not likely use this member function. Use CBaseFilter::Run instead.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.