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
     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
     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:

     ALBADNOEVENTQS      no audio event queues are currently available.

     ALBADOUTOFMEM      insufficient memory is available to allocate the
                            ALeventQueue.

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










                                                                        Page 1