ALgetqueuesize(3dm)ALgetqueuesize(3dm)NAME
ALgetqueuesize, ALsetqueuesize - (obsolete) get/set audio port buffer
size information in an ALconfig structure
SYNOPSIS
#include <dmedia/audio.h>
long ALgetqueuesize(ALconfig config)
int ALsetqueuesize(ALconfig config, const long size)
PARAMETER
config expects an ALconfig structure. This structure is the returned
value of an ALnewconfig(3dm) or ALgetconfig(3dm) call.
size expects the number of sample locations to use for the internal
buffer of an audio port created by a subsequent ALopenport(3dm)
call.
DESCRIPTIONALgetqueuesize and ALsetqueuesize are obsolete and provided for backward
compatibility. The preferred functions are alGetQueueSize(3dm) and
alSetQueueSize(3dm), both of which use units of sample frames.
ALgetqueuesize(3dm) returns the number of sample locations that the
ALconfig structure specifies.
ALsetqueuesize(3dm) changes the number of sample locations that config
specifies. Later, when you call ALopenport(3dm) with this config
structure, an audio port is created with an internal buffer of size
sample locations.
ALgetqueuesize(3dm) can fail for the following reason:
AL_BAD_CONFIG config is invalid or null.
ALsetqueuesize(3dm) can fail for the following reasons:
AL_BAD_CONFIG config is invalid or null.
AL_BAD_QSIZE size is invalid (either negative or larger than the
maximum allowable queue size).
NOTE
On IRIS systems with high-quality audio (e.g. Indigo, Indigo2, and Indy),
the maximum queue size for a stereo port is currently 131069, the minimum
queue size for a stereo port is 510; the maximum queue size for a mono
port is currently 262139, and the minimum queue size for a mono port is
1019. These values are somewhat nonintuitive. In the future, there should
be a way to obtain these values from ALgetminmax(3dm) or a similar
Page 1
ALgetqueuesize(3dm)ALgetqueuesize(3dm)
function. Note that ALsetqueuesize(3dm) can succeed if called with values
outside this range, but ALopenport(3dm) will fail due to a bad queue
size.
DIAGNOSTICS
Upon successful completion, ALgetqueuesize(3dm) returns a non-negative
number. Otherwise, -1 is returned.
ALsetqueuesize(3dm) returns 0 when successful. Otherwise, it returns -1.
Both functions set an error number which can be retrieved with
oserror(3C) in the case of failure.
SEE ALSOALnewconfig(3dm), ALgetconfig(3dm), ALsetconfig(3dm), ALopenport(3dm),
oserror(3C)
Page 2