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

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


alGetEventQueueFD(3dm)					alGetEventQueueFD(3dm)

NAME    [Toc]    [Back]

     alGetEventQueueFD - get the file descriptor for an	audio event queue

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     int alGetEventQueueFD(ALeventQueue	eventq)

PARAMETER    [Toc]    [Back]

     eventq   expects the ALeventQueue structure whose file descriptor you
	      desire.  This structure is the returned value of an
	      alOpenEventQueue(3dm) call.

DESCRIPTION    [Toc]    [Back]

     alGetEventQueueFD() returns a file	descriptor that	you can	use to
     construct the arguments to	a select(2)  or	poll(2)	call.

     These calls are used when you want	to block a process until a queue
     receives an audio event (see alSelectEvents(3dm)).	 At that time,
     select(2) and poll(2) return, and your code can retrieve the event
     information through calls to alNextEvent(3dm) or alCheckEvent(3dm).
     NOTE: alNextEvent(3dm) will block if passed an event queue	that is	empty.

     When using	select(2), an event queue file descriptor is used in a read

     When using	poll(2), an event queue	file descriptor	is used	with the
     POLLIN event flag.

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, alGetEventQueueFD returns a valid file
     descriptor. Otherwise, alGetEventQueueFD returns -1 and sets an error
     number which can be retrieved with	oserror(3C).

     alGetEventQueueFD can fail	for the	following reason:

     AL_BAD_INVALID_EVENTQ   eventq is either invalid or null.

SEE ALSO    [Toc]    [Back]

     alSelectEvents(3dm), alOpenEventQueue(3dm), alNextEvent(3dm),
     alCheckEvent(3dm),	select(2), poll(2), oserror(3C)

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
qgetfd IRIX get the read file descriptor associated with the event queue
alOpenEventQueue IRIX open an audio event queue
alCloseEventQueue IRIX close an audio event queue
alSelectEvents IRIX Setup event queue to receive audio events.
poll Linux wait for some event on a file descriptor
AFopenfile IRIX allocate an AFfilehandle structure for an audio file identified by name / by a Unix file descriptor
AFidentifyfd IRIX retrieve the audio file format of a file descriptor / open AFfilehandle
alGetFD IRIX get the file descriptor for an audio port
ALgetfd IRIX (obsolete) get the file descriptor for an audio port
alPendingEvents IRIX Get total number of event queued in event queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service