mme_play_bookmark()

Start playback from a bookmark

Synopsis:

#include <mme/mme.h>


int mme_bookmark_play( mme_hdl_t *hdl,
                       uint64_t bookmarkid );


Arguments:

hdl
An MME connection handle.
bookmarkid
The bookmark ID from which to play.

Library:

mme

Description:

The function mme_play_bookmark() begins playing a track from the specified bookmark. Its behavior is like that of mme_play(), except that instead of playing the track from its beginning, mme_play_bookmark() starts playback from the bookmark.

Like mme_play(), mme_play_bookmark() requires that the track to be in the current track session. In addition, the track must have the specified bookmark.

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 verifies that the fid is valid. It doesn't verify that the file exists, or that it is playable.

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

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_bookmark_create(), mme_bookmark_delete(),