mme_stop()

Stop a track session

Synopsis:

#include <mme/mme.h>

int mme_stop( mme_hdl_t *hdl );

Arguments:

hdl
An MME connection handle.

Library:

mme

Description:

The function mme_stop() stops the track session currently playing in the specified control context. You can call this function even if no track session is playing.

Events

MME_EVENT_PLAYSTATE with mme_event_data_t.playstatespeed set to 0 (zero).

Blocking and validation

This function verifies that the track session in the control context is in playback mode and can be stopped.

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