mme_trksession_set_files()

Update the track list in a file-based track session

Synopsis:

#include <mme/mme.h>

int mme_trksession_set_files( mme_hdl_t *hdl,
                              uint64_t trksessionid,
                              int nfiles,
                              uint64_t *msid,
                              const char **filename,
                              unsigned offset, );

Arguments:

hdl
An MME connection handle.
trksessionid
The ID of the track session to update.
nfiles
The number of files to set in the track session.
msid
A pointer to an array of mediastore IDs matching the filename array.
Each msid in the msid array must:
filename
A pointer to an array of filenames of tracks to be played. The filename includes the path to the file on the mediastore, but it does not include the mountpath to the mediastore. The path in filename must begin with a “/” (slash). For example: /songs_folder/album_folder/.
offset
The offset to jump to in the new track session.

Library:

mme

Description:

The function mme_trksession_set_files() replaces list of tracks to play in a file-based track session with a new list.

If the offset argument is not 0, this value is considered the the offset (position) in the new track session that the MME should go to when it begins playback. This offset in the new tracksession must match currently playing track.

When mme_trksession_append_files() successfully appends a file or files to a track session it delivers an MME_EVENT_TRKSESSIONVIEW_UPDATE event to indicate to the client application that the track session has changed.

Events

MME_EVENT_TRKSESSIONVIEW_UPDATE.

Blocking and validation

This function doesn't block.

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_trksession_append_files(), mme_trksession_clear_files(), mme_trksession_get_info(), mme_trksession_resume_state(), mme_trksession_save_state()