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

     AL_BAD_INVALID_EVENTQ   eventq is either invalid or null.

     AL_BAD_INVALID_EVENT    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