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

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


alNewEvent(3dm)						       alNewEvent(3dm)

NAME    [Toc]    [Back]

     alNewEvent	- create and initialize	an audio ALevent structure

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALevent alNewEvent(void)    [Toc]    [Back]

DESCRIPTION    [Toc]    [Back]

     alNewEvent	creates	and initializes	an ALevent structure.  An ALevent
     structure contains	the event information of a particular audio system
     change.  Events are retrieved from	event queues through alNextEvent(3dm)
     and alCheckEvent(3dm).  All events	have an	audio parameter	associated
     with them.	 For example, an ALevent with an AL_RATE parameter means that
     an	AL_RATE	change occurred	on an audio resource. Please refer to
     alParams(3dm) for more information.

     To	access event information, use the following calls:
     alEventGetSrcResource(3dm), alEventGetResource(3dm), alGetEventUST(3dm),
     alGetEventData(3dm), alGetEventParam(3dm),	and alGetEventValue(3dm).
     Some non-scalar parameters	require	a call to alGetParams(3dm) in order to
     access the	event data information.	 Refer to alParams(3dm)	for more
     information on the	specific parameters and	their methods for retrieving
     data from an ALevent.

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, alNewEvent returns an opaque ALevent
     structure with all	its members initialized	to zero. If the	structure
     allocation	fails, alNewEvent returns 0 and	sets an	error number which can
     be	retrieved with oserror(3C).

     alNewEvent	can fail for the following reason:

     AL_BAD_OUT_OF_MEM	 insufficient memory is	available to allocate the
			 ALevent structure.

SEE ALSO    [Toc]    [Back]

     alFreeEvent(3dm), AlGetEventParam(3dm), alGetEventResorce(3dm),
     alGetEventSrcResource(3dm), alGetEventUST(3dm), alGetEventValue(3dm),
     alGetEventData(3dm), alParams(3dm), oserror(3C)

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
alFreeEvent IRIX deallocates an audio ALevent structure
alNewConfig IRIX create and initialize an audio ALconfig structure
ALnewconfig IRIX create and initialize an audio ALconfig structure
AFinitfilefmt IRIX initialize the audio file format type in an AFfilesetup structure
AFinittrackids IRIX initialize the list of audio track identifiers in an AFfilesetup structure.
AFnewfilesetup IRIX create and initialize an AFfilesetup structure
afInitFormatParams IRIX initialize the audio data format in an AFfilesetup for a specified audio track via dmParams
AFinitsampfmt IRIX initialize the audio data format in an AFfilesetup for a specified audio track
AFinitcompression IRIX configure the audio compression type and parameters in an AFfilesetup structure for an audio track
datframe IRIX structure of a frame of audio data on Digital Audio Tape (DAT)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service