ALnewconfig(3dm)

NAME
     ALnewconfig - create and initialize an audio ALconfig structure

SYNOPSIS
     #include <dmedia/audio.h>

     ALconfig ALnewconfig(void)

DESCRIPTION
     ALnewconfig is obsolete and is provided for backward compatibility. The
     preferred function is alNewConfig(3dm).

     Use ALnewconfig(3dm) to create and initialize an ALconfig structure. This
     structure is used to pass in configuration information when calling
     ALopenport(3dm) or ALsetconfig(3dm).

     To change the configuration information stored in an ALconfig structure,
     see the commands mentioned below in SEE ALSO.

     The default structure specifies a 100,000 sample stereo buffer, utilizing
     a 16-bit two's complement sample format.

     When an ALconfig structure is no longer needed it should be discarded
     with ALfreeconfig(3dm).

     ALnewconfig(3dm) can fail for the following reason:

     AL_BAD_OUT_OF_MEM   insufficient memory is available to allocate the
                         ALconfig structure.

DIAGNOSTICS
     Upon successful completion ALnewconfig(3dm) returns an opaque ALconfig
     structure initialized to the default values.  If the structure allocation
     fails, ALnewconfig(3dm) returns 0 and sets an error number which can be
     retrieved with oserror(3C).

SEE ALSO
     ALfreeconfig(3dm), ALqueuesize(3dm), ALsetwidth(3dm), ALsetchannels(3dm),
     ALopenport(3dm), ALsetconfig(3dm), ALgetconfig(3dm), oserror(3C)