alNextEvent - Retrieves front most event from queue
int alNextEvent(ALeventQueue eventq, ALevent event)
eventq expects a valid ALeventQueue structure from which you want to
retrieve audio events.
event expects an ALevent structure previously initialized by
alNextEvent(3dm) retrieves the next ALevent in eventq and places it in
event. If eventq is empty, the call will block until an ALevent is
received by eventq.
To process the event, use the following calls: alGetEventParam(3dm),
alGetEventUST(3dm), alGetEventValue(3dm), alGetEventData(3dm),
alGetEventResource(3dm), and alGetEventSrcResource(3dm).
Upon successful completion, alNextEvent returns 0. Otherwise, alNextEvent
returns -1 and sets an error number which can be retrieved with
alNextEvent can fail for the following reason:
AL_BAD_INVALID_EVENTQ eventq is either invalid or null.
AL_BAD_INVALID_EVENT event is either invalid or null.
alOpenEventQueue(3dm), alGetEventParam(2), alGetEventUST(2),
alGetEventValue(3dm), alGetEventData(3dm), alGetEventResource(3dm),
PPPPaaaaggggeeee 1111 [ Back ]