alNextEvent(3dm)					      alNextEvent(3dm)

NAME    [Toc]    [Back]

     alNextEvent - Retrieves front most	event from queue

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     int alNextEvent(ALeventQueue eventq, ALevent event)

PARAMETER    [Toc]    [Back]

     eventq   expects a	valid ALeventQueue structure from which	you want to
	      retrieve audio events.

     event    expects an ALevent structure previously initialized by
	      alNewEvent(3dm).

DESCRIPTION    [Toc]    [Back]

     alNextEvent(3dm) retrieves	the next ALevent in eventq and places it in
     event.  If	eventq is empty, the call will block until an ALevent is
     received by eventq.

     To	process	the event, use the following calls: alGetEventParam(3dm),
     alGetEventUST(3dm), alGetEventValue(3dm), alGetEventData(3dm),
     alGetEventResource(3dm),  and alGetEventSrcResource(3dm).

DIAGNOSTICS    [Toc]    [Back]

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

     alNextEvent can fail for the following reason:

     AL_BAD_INVALID_EVENTQ   eventq is either invalid or null.

     AL_BAD_INVALID_EVENT    event is either invalid or	null.

SEE ALSO    [Toc]    [Back]

     alOpenEventQueue(3dm), alGetEventParam(2),	alGetEventUST(2),
     alGetEventValue(3dm), alGetEventData(3dm),	alGetEventResource(3dm),
     alGetEventSrcResource(3dm), oserror(3C)


									PPPPaaaaggggeeee 1111