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 |