mm_player_get_trksession_tracks()

Get information on the media nodes associated with a tracksession.

Synopsis:

#include <mmplayer/mmplayerclient.h>
 
int mm_player_get_trksession_tracks( 
                        mmplayer_hdl_t *hdl, 
                        const uint64_t tsid, 
                        const int offset, 
                        int *limit, 
                        mmp_ms_node_t **media_nodes )

Arguments:

hdl
The mm-player connection handle
tsid
The tracksession ID
offset
The tracksession offset to starting reading tracks from
limit

On input, the maximum number of items requested. On output, the number of items actually found (if the function succeeded).

media_nodes
The media nodes of the tracks contained in the tracksession

Library:

mmplayerclient

Description:

Get information on the media nodes associated with a tracksession. This function allocates the necessary memory and populates the media_nodes array, with each array element storing information on a single track in the tracksession identified by tsid. It's the caller's responsibility to later deallocate the array memory.

You can restrict which tracks get retrieved by setting the offset and limit parameters. The offset parameter makes mm-player retrieve media nodes for only those tracks at or beyond a certain offset (i.e., playback position) within the tracksession. The limit parameter restricts how many tracks can be retrieved.

Returns:

0 on success, -1 on failure