alFreeEvent(3dm)

NAME
     alFreeEvent - deallocates an audio ALevent structure

SYNOPSIS
     #include <dmedia/audio.h>

     int alFreeEvent(ALevent event)

PARAMETER
     config   expects an ALevent structure, the returned value of
              alNewEvent(3dm)

DESCRIPTION
     alFreeEvent(3dm) deallocates an ALevent structure.  Since event will be
     deallocated, it cannot be used in subsequent audio library calls.  All
     information in the ALevent will be lost.

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

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

     AL_BAD_INVALID_EVENT   event is either invalid or null.

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