1giiSetEventMask(3)                    GGI                   giiSetEventMask(3)
2
3
4

NAME

6       giiSetEventMask, giiGetEventMask, giiAddEventMask, giiRemoveEventMask :
7       Set the types of events queued
8

SYNOPSIS

10       #include <ggi/gii.h>
11
12       int giiSetEventMask(gii_input_t inp, gii_event_mask evm);
13
14       gii_event_mask giiGetEventMask(gii_input_t inp);
15
16       int giiAddEventMask(gii_input_t inp, gii_event_mask evm);
17
18       int giiRemoveEventMask(gii_input_t inp, gii_event_mask evm);
19
20

DESCRIPTION

22       Calling giiSetEventMask indicates to LibGII  that  only  the  types  of
23       events that match the specified event mask will be read by the applica‐
24       tion in subsequent giiEventPoll(3) or  giiEventRead(3)  calls.   LibGII
25       can  then  save  time  and memory by skipping checks and not allocating
26       queues for events that will never be read out.  The default mask allows
27       all events.
28
29       giiAddEventMask  and  giiRemoveEventMask  are macros that set or delete
30       individual bits in the bitmask.
31              Note: giiSetEventMask is an advisory call.  For  correct  opera‐
32              tion,  the  application  still needs to pass a restrictive event
33              mask to the event reading functions.
34

RETURN VALUE

36       giiSetEventMask, giiAddEventMask and  giiRemoveEventMask  return  0  on
37       success or an gii-error(3) code otherwise.
38
39       giiGetEventMask returns the currently set mask.
40

SEE ALSO

42       gii_event_mask(3)
43
44
45
46libgii-1.0.x                      2006-12-30                giiSetEventMask(3)