mmr_stop()

Stop playback

Synopsis:

#include <renderer.h>

int mmr_stop( mmr_context_t *ctxt );

Arguments:

ctxt
A context handle.

Library:

mmrndclient

Description:

The function mmr_stop() stops playback of the context's input media. Depending on the type of the input media, stopping the playback may cause the play position to change or become indeterminate. If you're unsure of the behavior of the media being played, use the function mmr_seek() to seek to a known position before restarting playback.

Note that when playback is explicitly stopped using mmr_stop(), mm-renderer doesn't publish an error code. However, when the end of the currently playing track is reached, the error code is set to MMR_ERROR_NONE.

Returns:

0
Success.
-1
An error occurred. Use the function mmr_error_info() to retrieve information about the error.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes