mme_zone_create()

Create an output zone

Synopsis:

#include <mme/mme.h>

int mme_zone_create( mme_hdl_t *hdl,
                     const char *name,
                     uint64_t *zoneid );

Arguments:

hdl
An MME connection handle.
name
A pointer to the zone name.
zoneid
The zone ID returned by the function.

Library:

mme

Description:

The function mme_zone_create() creates an output zone. It returns the ID of the new zone it created.

The MME uses zones to manage output. Zones can be attached to a control context or detached from a control context. The MME sends playback from a control context only to the zones attached to that control context. For example, in an automobile with two zones: “driver” and “passengers”, the zone “passengers” could be attached to a control context playing a video, while the zone “driver” would not be attached. A DVD-video played back in the control context would be available only in the zone “passengers”, but not in the zone “driver”.

Events

None delivered.

Blocking and validation

This function executes to completion.

Returns:

0
Success: the ID of the created output zone.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_output_set_permanent(), mme_play_attach_output(), mme_play_detach_output(), mme_play_get_zone(), mme_play_set_zone(), mme_zone_delete()