alDeselectEvents(3dm) alDeselectEvents(3dm)
NAME
alDeselectEvents - Deselect event queue from receiving events from a
resource.
SYNOPSIS
#include <dmedia/audio.h>
int alDeselectEvents(ALeventQueue eventq, int resource
int *params, int nparams)
PARAMETER
eventq expects an ALeventQueue structure properly initialized by
alOpenEventQueue(3dm).
resource expects an int with the value of the resource you are interested
in unregistering.
params is an int pointer with a parameter list of the audio events you
wish to unregister.
nparams is an int with the total number of parameters of the list
params.
DESCRIPTION
alDeselectEvents stops eventq from receiving events from resource that
match parameters from the list params. Parameters in params that have
not been previously selected through alSelectEvents(3dm) will be ignored.
DIAGNOSTICS
Upon successful completion, alDeselectEvents returns 0. Otherwise,
alDeselectEvents returns -1 and sets an error number which can be
retrieved with oserror(3C).
alDeselectEvents can fail for the following reason:
ALBADINVALIDEVENTQ eventq is either invalid or null.
ALBADRESOURCE An invalid resource has been selected.
ALBADPARAM params is either invalid or null.
ALBADBUFFERLENGTHNEG nparams is either less than or equal to zero.
SEE ALSO
alOpenEventQueue(3dm), alSelectEvents(3dm), alParams(3dm), oserror(3C)
Page 1