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.

DESCRIPTION
     ALgetqueuesize 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
     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 ALSO
     ALnewconfig(3dm), ALgetconfig(3dm), ALsetconfig(3dm), ALopenport(3dm),
     oserror(3C)