snd_mixer_element_info_build()

Get information about a mixer element and allocate required buffering

Synopsis:

#include <sys/asoundlib.h>

int snd_mixer_element_info_build(
       snd_mixer_t *handle, 
       snd_mixer_element_info_t *element );

Arguments:

handle
The handle for the mixer device. This must have been created by snd_mixer_open().
element
A pointer to a snd_mixer_element_info_t.

Library:

libasound.so

Use the -l asound option with qcc to link against this library.

Description:

The snd_mixer_element_info_build() function performs the same task as snd_mixer_element_info(), but it also allocates the extra buffering that a caller must provide to hold the full element information.

Use snd_mixer_element_info_free() to free the additional memory this function allocates.

Returns:

EOK on success, a negative errno upon failure.

Errors:

-EINVAL
NULL mixer or info argument, or invalid element type.
-ENXIO
The element wasn't found.
-EIO
No element information available.
-ENOMEM
Buffer allocation failed.

Classification:

QNX Neutrino

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