ALgetchannels(3dm)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.
DESCRIPTIONALsetchannels 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).
Page 1
ALgetchannels(3dm)ALgetchannels(3dm)NOTEALsetconfig(3dm) will not change the channel setting. You can't change
the channel setting of an ALport after it has been opened.
SEE ALSOALnewconfig(3dm), ALopenport(3dm), ALgetconfig(3dm), ALwritesamps(3dm),
ALreadsamps(3dm), oserror(3C)
Page 2