mme_play_set_speed()

Sets playback speed and direction (forward, reverse, pause) for tracks

Synopsis:

#include <mme/mme.h>

int mme_play_set_speed( mme_hdl_t *hdl,
                        int speed );


Arguments:

hdl
An MME connection handle.
speed
The playback speed to set for the current track, expressed in units of 1/1000 of normal speed.

Library:

mme

Description:

The function mme_play_set_speed() sets the playback speed for the current track or file, including forward, reverse and pause.

The playback speed is expressed in units of 1/1000 of normal speed: 1000 means normal speed, 2000 means double speed, etc. Positive values mean forward, negative values mean reverse, and zero means pause. Values between 0 and 1000 are slow speed playback.


Note:
  • The requested speed can't be guaranteed for all devices. The graph used to play the track will select the supported speed closest to the one requested. The client application should use mme_play_get_status() to get the actual playback speed.
  • During fast forward or reverse, an iPod continuously increases speed until it reaches the beginning or end of a track, at which time it resets to normal speed.

Events

MME_EVENT_TIME when the function has completed work.

Blocking and validation

This function verifies that the requested time position is valid, and blocks until it has advanced playback to this time position.

Returns:

0
Success: the playback speed was set.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_play(), mme_play_get_info(), mme_play_get_output_attr(), mme_play_get_speed(), mme_play_get_status(), mme_play_set_output_attr()