ALgetfillpoint(3dm)

NAME
     ALgetfillpoint, ALsetfillpoint - (obsolete) control select() or poll()
     behavior of an audio port

SYNOPSIS
     #include <dmedia/audio.h>

     long ALgetfillpoint(ALport port)

     int ALsetfillpoint(ALport port, const long fillpoint)

PARAMETER
     port        expects an ALport structure.  This structure is the returned
                 value of an ALopenport(3dm) call.

     fillpoint   expects a long value, the fillpoint, in samples.

DESCRIPTION
     ALgetfillpoint and ALsetfillpoint are obsolete and are provided for
     backward compatibility.  The preferred functions are alGetFillPoint(3dm)
     and alSetFillPoint(3dm), both of which use units of sample frames.

     ALgetfillpoint(3dm) returns the current fillpoint of a port.

     ALsetfillpoint(3dm) sets the current fillpoint of a port.

     Used with ALgetfd(3dm) and select(2) or poll(2), controlling the
     fillpoint lets you programmatically relinquish control to other
     processes.

     An input port will trigger the return from a select(2) or poll(2) call
     when there are at least fillpoint samples available to be read.

     An output port will trigger the return from a select(2) or poll(2) call
     when there are more than fillpoint unfilled samples spaces.

     ALsetfillpoint does not perform any validity checking on the fillpoint;
     it is up to the application to pass in a correct value.

     The calls ALreadsamps(3dm) and ALwritesamps(3dm) may change the fillpoint
     so you should set it just before you call select(2) or poll(2).

     ALgetfillpoint(3dm) can fail for the following reason:

     AL_BAD_PORT   port is invalid or null.

     ALsetfillpoint(3dm) can fail for the following reasons:
     AL_BAD_PORT
          port is invalid or null.
DIAGNOSTICS
     Upon successful completion ALgetfillpoint(3dm) returns a non-negative
     number. Otherwise, ALgetfillpoint(3dm) returns -1 and sets an error
     number which can be retrieved with oserror(3C).

     Upon successful completion ALsetfillpoint(3dm) returns 0.  Otherwise,
     ALsetfillpoint(3dm) returns -1 and sets an error number which can be
     retrieved with oserror(3C).

SEE ALSO
     ALopenport(3dm), ALgetfd(3dm), ALgetqueuesize(3dm), ALgetfillable(3dm),
     ALgetfilled(3dm), oserror(3C)