snd_mixer_open_name()

Create a connection and handle to a mixer device specified by name

Synopsis:

#include <sys/asoundlib.h>

int snd_mixer_open_name( snd_mixer_t **handle, 
                         char *name );

Arguments:

handle
A pointer to a location where snd_mixer_open_name() can store a handle for the mixer device.
name
The full path of the mixer device to open (e.g. /dev/snd/mixerC0).

Library:

libasound.so

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

Description:

The snd_mixer_open_name() function creates a handle and opens a connection to the named mixer device. You'll use this handle when calling the other snd_mixer_* functions.

Returns:

Zero on success, or a negative value on error.

Errors:

-EACCES
Search permission is denied on a component of the path prefix, or the device exists and the permissions specified are denied.
-EINTR
The open() operation was interrupted by a signal.
-EMFILE
Too many file descriptors are currently in use by this process.
-ENFILE
Too many files are currently open in the system.
-ENOENT
The named device doesn't exist.
-ENOMEM
Not enough memory is available for the data structure.
-SND_ERROR_INCOMPATIBLE_VERSION
The audio driver version is incompatible with the client library that the application is using.

Classification:

QNX Neutrino

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