snd_card_name()

Find the card number for a given name

Synopsis:

#include <sys/asoundlib.h>

int snd_card_name ( const char *string );

Arguments:

string
The name of the card.

Library:

libasound.so

Description:

The snd_card_name() function returns the card number associated with the given card name.

Returns:

A card number (positive integer), or a negative error code.

Errors:

-EINVAL
The string argument is NULL, an empty string, or isn't the name of a card.
-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

See also:

snd_card_get_longname(), snd_card_get_name()