This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ado_mixer_playback_group_create()

Create a playback group

Synopsis:

#include <audio_driver.h>

ado_mixer_dgroup_t *ado_mixer_playback_group_create
  ( ado_mixer_t *mixer,
    char *name,
    uint32_t channels,
    ado_mixer_delement_t *vol_elem,
    ado_mixer_delement_t *mute_elem );

Arguments:

mixer

A pointer to the ado_mixer_t structure that specifies the mixer to create the group in. This structure was created by ado_mixer_create().

name

The name of the group, which can be up to 31 characters long. Elements are referred to by name, so be careful; for some standard names, see <asound.h>.

channels

A bitmap of the channels in the group; any combination of:

SND_MIXER_CHN_MASK_MONO
SND_MIXER_CHN_MASK_FRONT_LEFT
SND_MIXER_CHN_MASK_FRONT_RIGHT
SND_MIXER_CHN_MASK_FRONT_CENTER
SND_MIXER_CHN_MASK_REAR_LEFT
SND_MIXER_CHN_MASK_REAR_RIGHT
SND_MIXER_CHN_MASK_WOOFER
SND_MIXER_CHN_MASK_STEREO

vol_elem

The volume element for the group.

mute_elem

The mute element for the group.

Description:

The ado_mixer_playback_group_create() function automates the allocation and filling of an ado_mixer_dgroup_t structure representing a channel in the playback direction.

Returns:

A pointer to the newly created playback group.

Classification:

QNX Neutrino