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,
		  AL_DEFAULT_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_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    [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