This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

See also:

snd_card_get_longname(), snd_card_get_name()