alNextEvent(3dm)                                              alNextEvent(3dm)



NAME
     alNextEvent - Retrieves front most event from queue

SYNOPSIS
     #include <dmedia/audio.h>

     int alNextEvent(ALeventQueue eventq, ALevent event)

PARAMETER
     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
     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
     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:

     ALBADINVALIDEVENTQ   eventq is either invalid or null.

     ALBADINVALIDEVENT    event is either invalid or null.

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















                                                                        Page 1