ALgetfillable(3dm)

NAME
     ALgetfillable - (obsolete) report the number of unfilled sample locations
     in an audio port

SYNOPSIS
     #include <dmedia/audio.h>

     long ALgetfillable(ALport port)

PARAMETER
     port   expects the audio port you want to query.  This structure is the
            returned value of the ALopenport(3dm) call.

DESCRIPTION
     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).

DIAGNOSTICS
     Upon successful completion, ALgetfillable(3dm) returns a non-negative
     number.

SEE ALSO
     ALopenport(3dm), ALgetfilled(3dm)