snd_card_get_name()

Find the name for a given card number

Synopsis:

#include <sys/asoundlib.h>

int snd_card_get_name( int card,
                       char *name,
                       size_t size );

Arguments:

card
The card number.
name
A buffer in which snd_card_get_name() stores the name.
size
The size of the buffer, in bytes.

Library:

libasound.so

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

Description:

The snd_card_get_name() function gets the common name that's associated with the given card number, and stores as much of the name as possible in the buffer pointed to by name.

Returns:

Zero, or a negative error code.

Errors:

-EINVAL
The card number is invalid, or name is NULL.
-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
No memory available for 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