mmr_stop()

Stop playing.

Synopsis:

#include <mm/renderer/renderer.h>
 
int mmr_stop(mmr_context_t *ctxt)

Since:

BlackBerry 10.0.0

Arguments:

ctxt

A context handle.

Library:

libmmrndclient (For the qcc command, use the -l mrndclient option to link against this library)

Description:

Stop playing. A no-op if already stopped. Depending on the input media, stopping the playback may cause the playing position to change or even become indeterminate. Unless you know the behaviour of the media being played, use the function mmr_seek() to seek to a known position before restarting the playback.

When the playback is explicitly stopped using mmr_stop(), a MMR_EVENT_STATE event is generated and the context state is set to MMR_STATE_STOPPED.

Returns:

Zero on success, -1 on failure (use mmr_error_info()).