ALgetfillpoint(3dm)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.
DESCRIPTIONALgetfillpoint 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.
Page 1
ALgetfillpoint(3dm)ALgetfillpoint(3dm)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 ALSOALopenport(3dm), ALgetfd(3dm), ALgetqueuesize(3dm), ALgetfillable(3dm),
ALgetfilled(3dm), oserror(3C)
Page 2