CBaseMediaFilter::Run (Windows Embedded CE 6.0)
1/6/2010
Transitions the filter to State_Running state if it is not already in this state.
Syntax
HRESULT Run (
REFERENCE_TIME tStart
);
Parameters
- tStart
Reference time value corresponding to stream time 0.
Return Value
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |