alOpenEventQueue(3dm)                                    alOpenEventQueue(3dm)


NAME
     alOpenEventQueue - open an audio event queue

SYNOPSIS
     #include <dmedia/audio.h>

     ALeventQueue alOpenEventQueue(const char *name)

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


DESCRIPTION
     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
     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).


     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
     alCloseEventQueue(3dm), alSelectEvents(3dm), alDeselectEvents(3dm),
     alGetEventQueueFD(3dm), oserror(3C)


                                                                        Page 1