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

snd_mixer_group_read()

Get a mixer group's configurable parameters

Synopsis:

#include <sys/asoundlib.h>

int snd_mixer_group_read(
       snd_mixer_t *handle, 
       snd_mixer_group_t *group );

Arguments:

handle
The handle for the mixer device. This must have been created by snd_mixer_open().
group
A pointer to a snd_mixer_group_t structure that snd_mixer_group_read() fills in with information about the mixer group.

Library:

libasound.so

Description:

The snd_mixer_group_read() function reads the snd_mixer_group_t structure for the group identified by the gid substructure (for more information, see snd_mixer_gid_t).


Note: You must initialize the gid substructure before calling this function.

Returns:

Zero on success, or a negative error value on error.

Errors:

-EINVAL
Invalid handle argument.
-ENXIO
The group wasn't found.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Caveats:

The group struct must be initialized to a known state before making the call: use memset() to set the struct to zero, and then set the gid member to specify which group to read.

See also:

snd_mixer_gid_t, snd_mixer_group_t, snd_mixer_group_write(), snd_mixer_groups()