alGetEventData(3dm)                                        alGetEventData(3dm)


NAME
     alGetEventData - gets data from certain events with non-scalar
     parameters.

SYNOPSIS
     #include <dmedia/audio.h>

     void* alGetEventData(ALevent event)


PARAMETER
     event   expects an ALevent structure initialized by alNextEvent(3dm) or
             alCheckEvent(3dm).

DESCRIPTION
     alGetEventData returns the event data information as a void pointer. This
     call is used on certain non-scalar event parameters. Refer to
     alParams(3dm) for a complete list of parameters that return event
     information through alGetEventData(3dm).

     After reading the event data, the void pointer should be cast to an event
     information struct.  Again, refer to alParams(3dm) for a complete list
     event information structs.


EXAMPLE
     The following code fragment shows how to retrieve data from events with
     parameters of type AL_CONNECT.


          ALeventQueue     eventq;
          ALevent          event;
          ALconnectionInfo *info;
               .
               .
          /*
           * Get event from event queue
           */
          alNextEvent(eventq,event);
          switch(alGetEventParam(event)) {
          case AL_CONNECT:
              conn_info = (ALconnectionInfo *)alGetEventData(event);
                .
                .
                .
              break;
                .
                .
                .
          }


DIAGNOSTICS
     Upon successful completion, alGetEventData(3dm) returns a void pointer.
     Otherwise it returns NULL, and sets an error number. This error number
     can be retrieved with oserror(3C).

     alGetEventData can fail for the following reason:

     AL_BAD_INVALID_EVENT   event is invalid or null.

SEE ALSO
     alNewEvent(3dm), alNextEvent(3dm), alCheckEvent(3dm), alParams(3dm),
     alGetEventParam(3dm), alGetEventValue(3dm), alGetParams(3dm), oserror(3C)


                                                                        Page 2