Find the long name for a given card number
Synopsis:
#include <sys/asoundlib.h>
int snd_card_get_longname ( int card,
char *name,
size_t size );
Arguments:
- card
- The card number.
- name
- A buffer in which snd_card_get_longname() stores the name.
- size
- The size of the buffer, in bytes.
Library:
libasound.so
Use the -l asound option with
qcc
to link against this library.
Description:
The snd_card_get_longname() function gets the
long name 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 |