ALgetfillpoint(3dm) ALgetfillpoint(3dm)
ALgetfillpoint, ALsetfillpoint - (obsolete) control select() or poll()
behavior of an audio port
#include <dmedia/audio.h>
long ALgetfillpoint(ALport port)
int ALsetfillpoint(ALport port, const long fillpoint)
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.
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.
Page 1
ALgetfillpoint(3dm) ALgetfillpoint(3dm)
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).
ALopenport(3dm), ALgetfd(3dm), ALgetqueuesize(3dm), ALgetfillable(3dm),
ALgetfilled(3dm), oserror(3C)
alGetFillPoint(3dm) alGetFillPoint(3dm)
alGetFillPoint, alSetFillPoint - get or set low- or high-water mark for
an audio port
#include <dmedia/audio.h>
int alGetFillPoint(ALport port)
int alSetFillPoint(ALport port, const int fillpoint)
port expects an ALport structure. This structure is the returned
value of an alOpenPort(3dm) call.
fillpoint expects a integer value, the fillpoint, in sample frames.
alGetFillPoint returns the current fillpoint of a port.
alSetFillPoint sets the current fillpoint of a port.
Used with alGetFD(3dm) and select(2) or poll(2), controlling the
fillpoint lets you block a process until the number of sample frames in
an audio port reaches a given low- or high-water mark.
An input port will trigger the return from a select(2) or poll(2) call
when there are at least fillpoint sample frames available to be read.
For input ports, use the "readfds" fd_set with select(2) or the POLLIN
event flag with poll(2).
An output port will trigger the return from a select(2) or poll(2) call
when there are more than fillpoint empty sample frames in the port. For
output ports, use the "writefds" fd_set with select(2) or the POLLOUT
event flag with poll(2).
alSetFillPoint does not perform any validity checking on the fillpoint;
it is up to the application to pass in a correct value.
The calls alReadFrames(3dm), alDiscardFrames(3dm), alZeroFrames, and
alWriteFrames(3dm) may change the fillpoint so you should set it just
before you call select(2) or poll(2).
Upon successful completion alGetFillPoint returns a non-negative number.
Otherwise, alGetFillPoint returns -1 and sets an error number which can
be retrieved with oserror(3C).
alGetFillPoint can fail for the following reason:
Page 1
alGetFillPoint(3dm) alGetFillPoint(3dm)
AL_BAD_PORT port is invalid or null.
Upon successful completion alSetFillPoint returns 0. Otherwise,
alSetFillPoint returns -1 and sets an error number which can be retrieved
with oserror(3C).
alSetFillPoint can fail for the following reasons:
AL_BAD_PORT port is invalid or null.
alOpenPort(3dm), alGetFD(3dm), alGetQueueSize(3dm), alGetFillable(3dm),
alGetFilled(3dm), oserror(3C)
PPPPaaaaggggeeee 2222 [ Back ]
|
