alOpenEventQueue(3dm)					 alOpenEventQueue(3dm)

NAME    [Toc]    [Back]

     alOpenEventQueue -	open an	audio event queue

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALeventQueue alOpenEventQueue(const char *name)

PARAMETER    [Toc]    [Back]

     name	 An event queue	name is	a character string describing the
		 event queue. Event queue names	have a maximum length of 20
		 characters.

DESCRIPTION    [Toc]    [Back]

     alOpenEventQueue(3dm) allocates and partially initializes an audio	event
     queue (ALeventQueue). An audio event queue	is the mechanism through which
     an	application can	be notified of system audio changes without it having
     to	poll.

     A single application may have multiple event queues open simultaneously.
     There is, however,	a system-dependent limit to the	total number of	audio
     event queues active on a given system.

     After opening an event queue successfully,	it is ready to setup for event
     notification. Refer to alSelectEvents(3dm), alDeselectEvents(3dm),	and
     alGetEventQueueFD(3dm) for	more information on how	to setup an
     ALeventQueue.

DIAGNOSTICS    [Toc]    [Back]

     If	successful, alOpenEventQueue(3dm) returns a non-zero ALeventQueue
     handle. Otherwise,	alOpenEventQueue(3dm) returns a	null (0) ALeventQueue
     and sets an error code, which can be retrieved via	oserror(3C).

     alOpenEventQueue(3dm) can fail with the following error codes:

     AL_BAD_NO_EVENTQS	    no audio event queues are currently	available.

     AL_BAD_OUT_OF_MEM	    insufficient memory	is available to	allocate the
			    ALeventQueue.

SEE ALSO    [Toc]    [Back]

     alCloseEventQueue(3dm), alSelectEvents(3dm), alDeselectEvents(3dm),
     alGetEventQueueFD(3dm), oserror(3C)


									PPPPaaaaggggeeee 1111