mme_play_resume_msid()

Resume playback of a track session on a specified mediastore.

Synopsis:

#include <mme/mme.h>

int mme_play_resume_msid( mme_hdl_t *hdl,
                          uint64_t msid );

Arguments:

hdl
An MME connection handle.
msid
The ID of the mediastore for which to resume playback.

Library:

mme

Description:

The function mme_play_resume_msid() resumes playback of a track session on a specified mediastore at the point mme_trksession_save_state() saved the track session's state.


Note: For devices, such as iPods, where the device itself maintains state knowledge:
  • the function mme_play_resume_msid() creates a new track session and resumes playback where indicated by the device's memory.
  • calling mme_play_resume_msid() when the iPod device is in a stopped state will not resume playback, because a stopped iPod has no active track session that can be resumed.
  • after a call to mme_play_resume_msid(), you should wait for the MME_EVENT_PLAYSTATE event with the playstate set to MME_PLAYSTATE_PLAYING before querying the device or setting the random and repeat modes.

For more information, see the MME Developer's Guide:

Events

The function mme_play_resume_msid() delivers the following event:

Blocking and validation

This function blocks on qdb. In asynchronous mode, it attempts to validate the request (make sure the request makes sense) before releasing the caller.

Returns:

0
Success: the MME resumed playback of the track session for the mediastore.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_trksession_get_info(), mme_play_resume_msid() mme_trksession_resume_state() mme_trksession_save_state()