Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

MmSeek()

Seek in a multimedia graph

Synopsis:

int32_t MmSeek(MmGraph_t *graph,
               MmTime_t mt);

Arguments:

graph
A pointer to a graph.
mt
The media time to seek to, in microseconds.

Library:

mmedia

Description:

This function seeks the graph to the time mt (in microseconds). You don't need to pause and resume the graph; if the graph isn't already paused, MmSeek() calls MmPause(), does the seek, and then resumes the graph with MmResume().

MmSeek() calls the MediaControl->Seek() function for all filters in the graph.

Returns:

0
Success.
-1
An error occurred.

Examples:

  // Assuming the given graph is created, hooked up, started,
  // and we want to seek to 10 seconds into the playback,
  // and resume playback:

  MmPause(graph);
  MmSeek(graph,10000000);
  MmResume(graph);

Classification:

Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

MmPause(), MmResume()