mme_bookmark_create()

Create a bookmark for the playing track

Synopsis:

#include <mme/mme.h>

int mme_bookmark_create( mme_hdl_t *hdl,
                         const char *name,
                         uint64_t *bookmarkid );

Arguments:

hdl
An MME connection handle.
name
The bookmark name. Set to NULL if the bookmark name is not important.
bookmarkid
The bookmark ID.

Library:

mme

Description:

The function mme_bookmark_create() creates a bookmark on a playing track at the current point of the playback.

Bookmarks allow end users to mark points in tracks from which they want to resume playing these tracks. They are used by mme_play_bookmark(), which starts playback of a track in a track session at the specified bookmark instead of at their beginning.

Events

None delivered.

Blocking and validation

This function behaves as follows, depending on the MME connection:

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_delete(), mme_play_bookmark()