ALgetdefault(3dm)					     ALgetdefault(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     long ALgetdefault(long device, long parameter)

PARAMETER    [Toc]    [Back]

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

     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:

     AL_BAD_DEVICE	    device is not AL_DEFAULT_DEVICE.

     AL_BAD_DEVICE_ACCESS   audio device is inaccessible.

     AL_BAD_PARAM	    parameter is not a valid parameter for device.

DIAGNOSTICS    [Toc]    [Back]

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

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


									PPPPaaaaggggeeee 1111