snd_afm_open

Synopsis:

#include <sys/asoundlib.h>

int snd_afm_open_name( snd_afm_t **handle, 
                       char *filename );

Arguments:

handle: A pointer to a location where snd_afm_open_name() can store a handle for the AMP functional module. You'll need this handle when you call the other snd_afm_* functions.
filename: The name of the AFM to open, including the directory, /dev/snd/.

Library:

libasound.so

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

Description:

(QNX Software Development Platform 6.6 io-audio patch [patch ID 4510] or later) The snd_afm_open_name() function creates a handle and opens a connection to the named AMP Functional Module (AFM). AFMs are installed in /dev/snd and their names are in the form afmCxDy, where x is the card number, and y is the device number. The card number depends on the order in which the cards are specified in the io-audio .conf file. Each AFM also has a symbolic name associated with (e.g., icc, voice, anc, and ese).

Using names for AFMs (snd_afm_open_name()) is preferred to using numbers (snd_afm_open()).

Returns:

EOK on success, or a negative errno upon failure. The errno values are available in the errno.h file.

Errors:

-EINVAL: The filename is NULL or an empty string.
-ENOMEM: There wasn't enough memory to allocate control structures.
-SND_ERROR_INCOMPATIBLE_VERSION: The audio driver version is incompatible with the client library that the application is using.

This function can also return the negative of the values that open() can assign to errno.

Classification:

QNX Neutrino

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