alCloseEventQueue(3dm)

NAME
     alCloseEventQueue - close an audio event queue

SYNOPSIS
     #include <dmedia/audio.h>

     int alCloseEventQueue(ALeventQueue queue)

PARAMETER
     queue   expects the ALeventQueue handle for the audio event queue you
             want to close.  This handle is the returned value of the
             alOpenEventQueue(3dm) call.

DESCRIPTION
     alCloseEventQueue closes the given audio event queue and frees the
     associated resources.  Any events remaining in the queue will be lost.
     Since queue will be deallocated, it cannot be used in any subsequent
     audio library function calls.

DIAGNOSTICS
     Upon successful completion, alCloseEventQueue(3dm) returns 0. Otherwise
     alCloseEventQueue(3dm) returns -1 and sets an error number which can be
     retrieved using oserror(3C).

     alCloseEventQueue(3dm) can fail for the following reason:

     AL_BAD_INVALID_EVENT_QUEUE
                   ALeventQueue is either invalid or null.

SEE ALSO
     alOpenEventQueue(3dm), oserror(3C)