*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> audio/ALgetname (3d)              


ALgetname(3dm)							ALgetname(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     char* ALgetname(long device, long descriptor)

PARAMETER    [Toc]    [Back]

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

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

DESCRIPTION    [Toc]    [Back]

     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_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    [Toc]    [Back]

     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    [Toc]    [Back]

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

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
ALgetdefault IRIX (obsolete) returns the default value for an audio device state variable
ALgetminmax IRIX (obsolete) gets maximum and minimum values for an audio device state variable
ALqueryparams IRIX (obsolete) get descriptor/description pairs for audio device state variables
ALgetparams IRIX (obsolete) get/set the value of the specified audio device states
ALopenport IRIX (obsolete) open an audio port
ALwritesamps IRIX (obsolete) write samples to an audio port
ALreadsamps IRIX (obsolete) read samples from an audio port
ALcloseport IRIX (obsolete) releases resources of an audio port
ALfreeconfig IRIX (obsolete) deallocates an audio ALconfig structure
ALgetfd IRIX (obsolete) get the file descriptor for an audio port
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service