ALgetdefault(3dm)                                            ALgetdefault(3dm)



NAME
     ALgetdefault - (obsolete) returns the default value for an audio device
     state variable

SYNOPSIS
     #include <dmedia/audio.h>

     long ALgetdefault(long device, long parameter)

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

     parameter   expects the symbolic constant for the device state variable
                 for which you want the default value.

DESCRIPTION
     ALgetdefault is obsolete and is provided for backward compatibility. The
     preferred method to get the default value for a parameter is
     alGetParamInfo(3dm).

     ALgetdefault(3dm) returns the default value for the device state variable
     referenced in parameter.

     Device state variables specify parameters of the audio hardware which can
     be changed under program control.

     Default values are the values of the device parameters which are in
     effect when the system is booted and represent suggested nominal values.
     You can find a listing of parameters and their descriptions in
     ALgetparams(3dm).

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

     ALBADDEVICE          device is not AL_DEFAULT_DEVICE.

     ALBADDEVICEACCESS   audio device is inaccessible.

     ALBADPARAM           parameter is not a valid parameter for device.

DIAGNOSTICS
     Upon successful completion, ALgetdefault(3dm) returns the default value
     for parameter. Otherwise, ALgetdefault(3dm) returns -1 and sets an error
     number which can be retrieved with oserror(3C).

SEE ALSO
     ALgetparams(3dm), ALqueryparams(3dm), ALgetminmax(3dm), ALgetname(3dm),
     oserror(3C)







                                                                        Page 1