mme_trksession_resume_state()

Resume playing a track session at the last saved position

Synopsis:

#include <mme/mme.h>

int mme_trksession_resume_state( mme_hdl_t *hdl );

Arguments:

hdl
An MME connection handle.

Library:

mme

Description:

The function mme_trksession_resume_state() resumes playing a track session at the point its state was saved by a call to mme_trksession_save_state().


Note: Before stopping a track session, you must use the function mme_trksession_save_state() to save its state. After you have saved the track session's state, you can stop playback, then call the functions mme_settrksession() and mme_trksession_resume_state() at any time to resume playback.

For more information about stopping and resuming playback of track sessions, see Stopping and resuming playback in the chapter Playing Media.

Events

This function may deliver any event of the class MME_EVENT_CLASS_PLAY, and any MME_PLAY_ERROR_* event.

Blocking and validation

This function does not verify that the fid is in the track session. If the connection to the MME is synchronous, the function validates that the file exists and that it is playable.

This function blocks on control contexts. If mme_trksession_resume_state() is called and another function is called before mme_trksession_resume_state() returns, the second function blocks on io-media until mme_trksession_resume_state() returns. If there are no other pending calls, mme_trksession_resume_state() returns without blocking on io-media.

Returns:

0
Success: MME resumed playback of the track session.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_trksession_append_files(), mme_trksession_clear_files(), mme_trksession_get_info(), mme_trksession_save_state(), mme_trksession_set_files()