ALgetfillable(3dm) ALgetfillable(3dm)
ALgetfillable - (obsolete) report the number of unfilled sample locations
in an audio port
#include <dmedia/audio.h>
long ALgetfillable(ALport port)
port expects the audio port you want to query. This structure is the
returned value of the ALopenport(3dm) call.
ALgetfillable is obsolete and is provided for backward compatibility. The
preferred function is alGetFillable(3dm), which returns the number of
fillable sample frames in a port.
ALgetfillable(3dm) returns the number of sample locations in an audio
port that have not yet been filled. How you interpret this number
depends on whether port is an input port or an output port.
For an input port, the return value is a count of spaces that the device
can fill up before the port overflows, causing a loss of samples.
For an output port, the return value is the greatest number of samples
that can be written to the port without blocking (i.e. waiting for more
samples to be played).
Because the port continues to empty or fill, the number returned by
ALgetfillable(3dm) is an instantaneous measurement of the number of
fillable locations. For input ports, this number will decrease over time
as new samples arrive. For output, ports this number will increase as
samples are played.
In order to insure the best possible performance, ALgetfillable(3dm)
performs no verification of port. You should make certain that port is a
valid ALport structure before passing it as a parameter to
ALgetfillable(3dm).
Upon successful completion, ALgetfillable(3dm) returns a non-negative
number.
ALopenport(3dm), ALgetfilled(3dm)
alGetFillable(3dm) alGetFillable(3dm)
alGetFillable - report the number of unfilled sample frames in an audio
port
#include <dmedia/audio.h>
int alGetFillable(ALport port)
port expects the audio port you want to query. This structure is the
returned value of the alOpenPort(3dm) call.
alGetFillable returns the number of sample frames in an audio port that
have not yet been filled. How you interpret this number depends on
whether port is an input port or an output port.
For an input port, the return value is a count of spaces that the device
can fill up before the port overflows, causing a loss of samples.
For an output port, the return value is the greatest number of sample
frames that can be written to the port without blocking (i.e. waiting for
more samples to be played).
Because the port may continue to empty or fill, the number returned by
alGetFillable is an instantaneous measurement of the number of fillable
locations. For input ports, this number will decrease over time as new
samples arrive. For output, ports this number will increase as samples
are played.
In order to insure the best possible performance, alGetFillable performs
no verification of port. You should make certain that port is a valid
ALport structure before passing it as a parameter to alGetFillable.
Upon successful completion, alGetFillable returns a non-negative number.
alOpenPort(3dm), alGetFilled(3dm)
PPPPaaaaggggeeee 1111 [ Back ]
|
