alGetFillable(3dm)                                          alGetFillable(3dm)


NAME
     alGetFillable - report the number of unfilled sample frames in an audio
     port

SYNOPSIS
     #include <dmedia/audio.h>

     int 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 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.

DIAGNOSTICS
     Upon successful completion, alGetFillable returns a non-negative number.

SEE ALSO
     alOpenPort(3dm), alGetFilled(3dm)


                                                                        Page 1