![]() |
![]() |
![]() |
![]() |
Skip to the next track
#include <mme/mme.h> int mme_next( mme_hdl_t *hdl );
mme
The function mme_next() skips to the next track in the currently playing track session.
The behavior of mme_next() is affected by the play modes set for the specified control context (sequential versus random, and repeat versus no repeat).
If sequential mode is set, the next track in the track session is determined by the sequentialid field in the next row of the trksessionview table. The order of the file IDs in this table column is determined by the ORDER BY clause used to create the track session.
If random mode is set, the next track in the track session is determined by the randomid field in the next row of the trksessionview table. The order of the file IDs in this table column is generated by the MME when it sets the track session.
When the last track in the track session is playing, the result of calling mme_next() depends on whether the repeat mode is set.
If repeat is off, mme_next() sets errno to ENODATA when it has reached the end of the track session (or, when random mode is set, when all songs in the trackssessin have been played).
If repeat is on:
iPod devices manage their own track sessions. To move to the next or previous track in an iPod track session, call the mme_button() function with mm_button_t set to MM_BUTTON_NEXT or MM_BUTTON_PREV, as required.
Any event of the class MME_EVENT_CLASS_PLAY, and any MME_PLAY_ERROR_* event.
Verifies that the fid is valid. Does not verify that the file exists, or that it is playable.
This function blocks on control contexts. If mme_next() is called and another function is called before mme_next() returns, the second function blocks on io-media until mme_next() returns. If there are no other pending calls, mme_next() returns without blocking on io-media.
QNX Neutrino
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | Yes |
mme_prev(), mme_setrandom(), mme_setrepeat()
![]() |
![]() |
![]() |
![]() |