*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> audio/alOpenEventQueue (3d)              


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

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

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

SEE ALSO    [Toc]    [Back]

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

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
alCloseEventQueue IRIX close an audio event queue
alGetEventQueueFD IRIX get the file descriptor for an audio event queue
alSelectEvents IRIX Setup event queue to receive audio events.
alPendingEvents IRIX Get total number of event queued in event queue
alCheckEvent IRIX Looks for an event in the event queue and retrieves it.
mq_open HP-UX create/open a message queue
mq_open IRIX open/create a message queue
qcontrol IRIX administers event queue
qreset IRIX empties the event queue
alNextEvent IRIX Retrieves front most event from queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service