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).

     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"


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


     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