mme_play_file()

Play a track on an unsynchronized mediastore

This function is deprecated. Use file-based track sessions; see Creating and modifying file-based track sessions in the MME Developer's Guide.

Synopsis:

#include <mme/mme.h>

int mme_play_file( mme_hdl_t *hdl,
                   uint64_t msid,
                   const char *filename );

Arguments:

hdl
The handle of the control context.
msid
The ID of the mediastore with the track to be played.
filename
The path and filename of the track to play. The filename includes the path to the file on the mediastore, but it does not include the mountpath to the mediastore. The path in filename must begin with a “/” (slash). For example: /songs_folder/album_folder/.

Library:

mme

Description:

The function mme_play_file() plays a track on a mediastore regardless of whether the mediastore has been synchronized. This function can only be used to play a track on a mediastore that has its capabilities field in the mediastores table set to MME_MSCAP_PLAY_FILE.

Like mme_play(), in order to play a track, mme_play_file() requires a track session to be set, but does not require the track to be in the set track session.

Events

This function may deliver any event of the class MME_EVENT_CLASS_PLAY, and any MME_PLAY_ERROR_* event.

Blocking and validation

This function does not verify that the fid is in the track session. If the connection to the MME is synchronous, the function validates that the file exists and that it is playable.

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