alPendingEvents(3dm)                                      alPendingEvents(3dm)


NAME
     alPendingEvents - Get total number of event queued in event queue

SYNOPSIS
     #include <dmedia/audio.h>

     int alPendingEvents(ALeventQueue eventq)

PARAMETER
     eventq   expects a valid ALeventQueue initialized by
              alOpenEventQueue(3dm).


DESCRIPTION
     eventq.  If the event queue is empty, it returns 0.

DIAGNOSTICS
     Upon successful completion, alPendingEvents will return an int value with
     the number of events queued in eventq.  Otherwise, alPendingEvents
     returns -1 and sets an error number which can be retrieved with
     oserror(3C).

     alPendingEvents can fail for the following reason:

     AL_BAD_INVALID_EVENTQ   eventq is either invalid or null.

SEE ALSO
     alOpenEventQueue(3dm), oserror(3C)


                                                                        Page 1