ALgetqueuesize(3dm) ALgetqueuesize(3dm)
ALgetqueuesize, ALsetqueuesize - (obsolete) get/set audio port buffer
size information in an ALconfig structure
#include <dmedia/audio.h>
long ALgetqueuesize(ALconfig config)
int ALsetqueuesize(ALconfig config, const long size)
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.
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).
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
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.
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.
ALnewconfig(3dm), ALgetconfig(3dm), ALsetconfig(3dm), ALopenport(3dm),
oserror(3C)
Page 2
alGetQueueSize(3dm) alGetQueueSize(3dm)
alGetQueueSize, alSetQueueSize - get/set audio port buffer size
#include <dmedia/audio.h>
int alGetQueueSize(ALconfig config)
int alSetQueueSize(ALconfig config, const int size)
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 frames to use for the internal
buffer of an audio port created by a subsequent alOpenPort(3dm)
call.
alGetQueueSize returns the number of sample frames that the ALconfig
structure specifies.
alSetQueueSize changes the number of sample frames that config specifies.
Later, when you call alOpenPort with this config structure, an audio port
is created with an internal buffer of size audio sample frames. queue
size).
alGetQueueSize normally returns a non-negative number. If an error
occurs, it returns -1, and sets an error code which can be retrieved via
oserror(3C).
alGetQueueSize can set the following error code:
AL_BAD_CONFIG config is invalid or null.
alSetQueueSize returns 0 when successful. If an error occurs, it returns
-1, and sets an error code which can be retrieved via oserror(3C).
alSetQueueSize can set the following error codes:
AL_BAD_CONFIG config is invalid or null.
AL_BAD_QSIZE size is invalid (either negative or larger than the
maximum allowable
alNewConfig(3dm), alGetConfig(3dm), alSetConfig(3dm), alOpenPort(3dm),
oserror(3C)
PPPPaaaaggggeeee 1111 [ Back ]
|
