mme_trksession_save_state()

Save the playing position of the current track session

Synopsis:

#include <mme/mme.h>

int mme_trksession_save_state( mme_hdl_t *hdl );

Arguments:

hdl
An MME connection handle.

Library:

mme

Description:

The function mme_trksession_save_state() saves the playing position of the current track session. If you want to be able to stop a track session then resume playing it at a later time, you must use this function to save its playing position before you interrupt it.


Note: If the track session is on a device, such as an iPod, that manages its own track sessions, do not call mme_trksession_save_state(). The device is responsible for saving its state, and will resume playback from the correct point when you call mme_play_resume_msid().

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

Events

None delivered.

Blocking and validation

This function may block on the control context, qdb or io-media. Depending on the MME connection, it behaves as follows:

Returns:

0
Success: the MME saved the state of the current 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_resume_state(), mme_trksession_set_files()