Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ALgetname(3dm)							ALgetname(3dm)

NAME
     ALgetname - (obsolete) returns a name for an audio device state variable

SYNOPSIS
     #include <dmedia/audio.h>

     char* ALgetname(long device, long descriptor)

PARAMETER
     device	  expects a device.  Currently there is only one device,
		  AL_DEFAULT_DEVICE.

     descriptor	  expects the descriptor (value of a symbolic constant) for
		  the device state variable you want to identify.

DESCRIPTION
     ALgetname is obsolete and is provided for backward compatibility. The
     preferred function is alGetParamInfo(3dm).

     ALgetname(3dm) returns a pointer to a null-terminated string suitable for
     use as a label to describe this state variable.  This string should be
     considered "read only".

     Subsequent calls to ALgetname(3dm) may over-write the contents of the
     returned string. If you rely upon the value of this string, you should
     copy it before again calling ALgetname(3dm).

     The current mapping between device state variables and names is:  [not
     all parameters are present on all systems]

	  AL_INPUT_SOURCE     "Line/MIC/AES"
	  AL_LEFT_INPUT_ATTEN	   "Left Input Atten"
	  AL_RIGHT_INPUT_ATTEN	   "Right Input Atten"
	  AL_INPUT_RATE	      "Input Rate"
	  AL_OUTPUT_RATE      "Output Rate"
	  AL_LEFT_SPEAKER_GAIN	   "Left Output Gain"
	  AL_RIGHT_SPEAKER_GAIN	   "Right Output Gain"
	  AL_INPUT_COUNT      "Input Count"
	  AL_OUTPUT_COUNT	   "Output Count"
	  AL_UNUSED_COUNT	   "Unused Count"
	  AL_SYNC_INPUT_TO_AES	   "Sync input to AES input"
	  AL_SYNC_OUTPUT_TO_AES	   "Sync output to AES input"
	  AL_MONITOR_CTL	  "Monitor control"
	  AL_LEFT_MONITOR_ATTEN	  "Left monitor atten"
	  AL_RIGHT_MONITOR_ATTEN  "Right monitor atten"
	  AL_SPEAKER_MUTE_CTL	  "Speaker mute control"
	  AL_MIC_MODE	      "Microphone mode"
	  AL_CHANNEL_MODE	   "System Channel Mode"
	  AL_DIGITAL_INPUT_RATE	   "Digital Input Rate"

									Page 1

ALgetname(3dm)							ALgetname(3dm)

     To get descriptors for all the state variables associated with a device,
     call ALqueryparams(3dm).

     ALgetname(3dm) can fail for the following reasons:

     AL_BAD_DEVICE	    device is invalid.

     AL_BAD_DEVICE_ACCESS   audio hardware is inaccessible.

     AL_BAD_PARAM	    descriptor is not valid for device.

DIAGNOSTICS
     In the case of failure, ALgetname(3dm) returns a null-valued pointer and
     sets an error number which can be retrieved with oserror(3C).

SEE ALSO
     ALqueryparams(3dm), ALgetminmax(3dm), ALgetdefault(3dm), oserror(3C)

									Page 2

Vote for polarhome