alGetEventResource(3dm)				       alGetEventResource(3dm)

NAME    [Toc]    [Back]

     alGetEventResource	- Return audio resource	that posted event

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     ALvalue alGetEventResource(ALevent	event)

PARAMETER    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     alGetEventResource	returns	the value of the resource that posted the
     event. A resource will post an event to an	event queue if it was selected
     through alSelectEvents(3dm).

     It	is important to	note that the return value of alGetEventResource(3dm)
     is	not necessarily	the same value of the resource that generated the
     event.  Similar to	alGetParams(3dm) and alQueryParams(3dm), audio events
     follow a resource hierarchy. For example, one can set AL_RATE on a
     device, even though the parameter is really handled by the	device's
     clock-generator, a	separate resource. Similarly, if one requests an event
     for AL_RATE on a device, an event will be posted when the AL_RATE on its
     clock-generator changes. In this case, we say that	the device posted the
     event, and	that the clock-generator generated the event. To obtain	the
     value of the resource that	generated the event, use
     alGetEventSrcResource(3dm).

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, alGetEventResource(3dm) returns a non zero
     resource.	Otherwise, it returns zero, and	sets an	error number. This
     error number can be retrieved with	oserror(3C).

     alGetEventResource	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), alGetEventSrcResource(3dm),
     alQueryParams(3dm),oserror(3C)


									PPPPaaaaggggeeee 1111