mme_media_set_def_lang()

Set the preferred media playback language

Synopsis:

#include <mme/mme.h>

int mme_media_set_def_lang ( mme_hdl_t *hdl,
                             const char *lang );

Arguments:

hdl
An MME connection handle.
lang
The default language code to set. This is a string containing 2-character ISO639-1 language code. See http://www.loc.gov/standards/iso639-2/php/code_list.php

Library:

mme

Description:

The function mme_media_set_def_lang() sets the preferred language for media playback. After this function sets the language preference for the current MME control context, the MME uses the selected language as the default langauge for playback whenever possible. For example, mme_media_set_def_lang() sets the preferred language to German:

If mme_media_set_def_lang() is not called after connecting to the MME, no language preference is selected, and the MME will play media in the preferred language set on the mediastores.

Events

The function mme_media_set_def_lang() delivers the MME_EVENT_DEFAULT_LANGUAGE so that asynchronous clients are notified that the default preferred language has been successfully set, or that the attempt to change the language has failed.

Blocking and validation

This function doesn't block.

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_media_get_def_lang()