*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> audio/alGetEventValue (3d)              


alGetEventValue(3dm)					  alGetEventValue(3dm)

NAME    [Toc]    [Back]

     alGetEventValue - get ALvalue of audio event

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALvalue alGetEventValue(ALevent event)    [Toc]    [Back]

PARAMETER    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     alGetEventValue returns the event data information	as an ALvalue union
     from the ALevent structure.

     As	with alGetParams(3dm), the ALvalue type	will depend on the parameter.
     For a complete list of event parameters and their data types, refer to
     alParams(3dm).   The event	parameter can be retrieved through

     It	is important to	note that non-scalar data type parameters will use
     different calls for event data retrieval:	alGetEventData(3dm) and
     alGetParams(3dm).	Again, please refer to alParams(3dm) for more

EXAMPLE    [Toc]    [Back]

     The following example demonstrates	how to retrieve	the event data
     information of an event with an AL_RATE parameter.

     ALeventQueue eventq;
     ALevent	  event;
     ALvalue	  value;
      *	Get event from event queue
     status = alNextEvent(eventq,event);
     if(status == -1) {
	  fprintf(stderr,"Error	retrieving event: %s",

      *	Process	the event.
     switch(alGetEventParam(event)) {
     case AL_RATE:

									Page 1

alGetEventValue(3dm)					  alGetEventValue(3dm)

	 value = alGetEventValue(event);
	 fprintf(stdout,"New Rate: %lf\n",

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, alGetEventValue(3dm) returns an ALvalue union
     with the particular event information.  Otherwise,	it returns an ALvalue
     with its field set	to zero, and sets an error number. This	error number
     can be retrieved with oserror(3C).

     alGetEventValue can fail for the following	reason:

     AL_BAD_INVALID_EVENT   event is invalid or	null.

SEE ALSO    [Toc]    [Back]

     alNewEvent(3dm), alNextEvent(3dm),	alCheckEvent(3dm), alParams(3dm),
     alGetEventData(3dm), alGetParams(3dm), oserror(3C)

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
alGetEventParam IRIX get parameter of audio event
alCloseEventQueue IRIX close an audio event queue
alOpenEventQueue IRIX open an audio event queue
alGetEventQueueFD IRIX get the file descriptor for an audio event queue
alGetEventResource IRIX Return audio resource that posted event
alGetEventUST IRIX get Unadjusted System Time of audio event
alGetEventSrcResource IRIX Return audio resource that generated event
alSelectEvents IRIX Setup event queue to receive audio events.
alPendingEvents IRIX Get total number of event queued in event queue
AFinitcompression IRIX configure the audio compression type and parameters in an AFfilesetup structure for an audio track
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service