ALgetchannels(3dm)

NAME
     ALgetchannels, ALsetchannels - (obsolete) get/set the channel setting in
     an audio ALconfig structure

SYNOPSIS
     #include <dmedia/audio.h>

     long ALgetchannels(ALconfig config)
     int ALsetchannels(ALconfig config, long channels)

PARAMETER
     config     expects an ALconfig structure, the returned value of
                ALnewconfig(3dm) or ALgetconfig(3dm).

     channels   expects a long value indicating the number of samples per
                sampling interval.  The currently valid values are: 1, 2, and
                4.

DESCRIPTION
     ALsetchannels and ALgetchannels are obsolete and are provided for
     backward compatibility. The preferred functions are alSetChannels(3dm)
     and alGetChannels(3dm).

     ALgetchannels(3dm) returns the channel setting of the argument config.

     ALsetchannels(3dm) sets the channel setting in an ALconfig structure.
     The channel setting configures the audio port for mono, stereo, or 4-
     channel audio.  All ports that you open with this ALconfig structure will
     have the channel setting that you specify in channels.

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

     AL_BAD_CONFIG   config is either invalid or null.

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

     AL_BAD_CONFIG     config is either invalid or null.

     AL_BAD_CHANNELS   channels is not one of 1, 2, or 4.

DIAGNOSTICS
     Upon successful completion, ALgetchannels(3dm) returns a number greater
     than 0. Otherwise, ALgetchannels(3dm) returns -1 and sets an error number
     which can be retrieved using oserror(3C).

     ALsetchannels(3dm) returns 0 when successfully called. Otherwise,
     ALsetchannels(3dm) returns -1 and sets an error number which can be
     retrieved using oserror(3C).
NOTE
     ALsetconfig(3dm) will not change the channel setting.  You can't change
     the channel setting of an ALport after it has been opened.

SEE ALSO
     ALnewconfig(3dm), ALopenport(3dm), ALgetconfig(3dm), ALwritesamps(3dm),
     ALreadsamps(3dm), oserror(3C)