mme_setrepeat()

Sets the repeat playback mode for a control context

Synopsis:

#include <mme/mme.h>

int mme_setrepeat( mme_hdl_t   *hdl,
                   int mode );

Arguments:

hdl
An MME connection handle.
mode
The repeat mode. For a list of repeat modes, see mmme_mode_repeat_t.

Library:

mme

Description:

The function mme_setrepeat() sets the repeat playback mode for a control context. If random playback mode is enabled and the repeat mode is MME_REPEAT_ALL, when all the tracks in a tracksession are played once, the MME determines a new pseudo-random order, and the first track in the new list starts playing. Playback will continue indefinitely.

If the repeat mode is MME_REPEAT_SINGLE, the current track repeats indefinitely.


Note: A random or repeat mode setting only works if the external device supports the setting. If the external device doesn't support the requested setting, the MME logs a warning and continues playback.

Events

This function returns MME_EVENT_REPEATCHANGE when it has completed work.

Blocking and validation

This function blocks on control contexts. If mme_setrepeat() is called and another function is called before mme_setrepeat() returns, the second function blocks on io-media until mme_setrepeat() returns. If there are no other pending calls, mme_setrepeat() 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_getrandom(), mme_getrepeat(), mme_getscanmode() mme_setrandom(), mmme_mode_random_t, mmme_mode_repeat_t