Microsoft Windows CE 3.0  

CBaseMediaFilter::Run

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

HRESULT Run (
REFERENCE_TIME
tStart
);

Parameters

tStart
Reference time value corresponding to stream time 0.

Return Values

Returns an HRESULTvalue.

Remarks

If the filter is in State_Stopped state, the CBaseMediaFilter::Pausemember 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::Activemember function, the function fails and the state is not changed. If this member function succeeds, the filter's m_Statemember variable is set to State_Running. This member function holds the filter's lock.

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