Export (0) Print
Expand All

IMFMediaEngineEx::SetTimelineMarkerTimer method

Specifies a presentation time when the Media Engine will send a marker event.

Syntax


HRESULT SetTimelineMarkerTimer(
  [in]  double timeToFire
);

Parameters

timeToFire [in]

The presentation time for the marker event, in seconds.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When playback reaches the time specified by timeToFire, the Media Engine sends an MF_MEDIA_ENGINE_EVENT_TIMELINE_MARKER event through the IMFMediaEngineNotify::EventNotify method. Calling this method cancels any previous marker that is still pending.

If the application seeks past the marker point, the Media Engine cancels the marker and does not send the event.

During forward playback, set timeToFire to a value greater than the current playback position. During reverse playback, set timeToFire to a value less than the playback position.

To cancel a marker, call IMFMediaEngineEx::CancelTimelineMarkerTimer.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Mfmediaengine.h

See also

IMFMediaEngineEx

 

 

Community Additions

ADD
Show:
© 2014 Microsoft