alPendingEvents(3dm)					  alPendingEvents(3dm)

NAME    [Toc]    [Back]

     alPendingEvents - Get total number	of event queued	in event queue

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     int alPendingEvents(ALeventQueue eventq)

PARAMETER    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     alPendingEvents(3dm) Returns the total number of events queued up in
     eventq.  If the event queue is empty, it returns 0.

DIAGNOSTICS    [Toc]    [Back]

     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    [Toc]    [Back]

     alOpenEventQueue(3dm), oserror(3C)


									PPPPaaaaggggeeee 1111