Man Linux: Main Page and Category List

NAME

       giiSetEventMask, giiGetEventMask, giiAddEventMask, giiRemoveEventMask -
       Set the types of events queued

SYNOPSIS

       #include <ggi/gii.h>

       int giiSetEventMask(gii_input_t inp, gii_event_mask evm);

       gii_event_mask giiGetEventMask(gii_input_t inp);

       int giiAddEventMask(gii_input_t inp, gii_event_mask evm);

       int giiRemoveEventMask(gii_input_t inp, gii_event_mask evm);

DESCRIPTION

       Calling giiSetEventMask indicates to LibGII  that  only  the  types  of
       events  that  match  the  specified  event  mask  will  be  read by the
       application in subsequent  giiEventPoll(3)  or  giiEventRead(3)  calls.
       LibGII  can  then  save  time  and  memory  by  skipping checks and not
       allocating queues for events that will never be read out.  The  default
       mask allows all events.

       giiAddEventMask  and  giiRemoveEventMask  are macros that set or delete
       individual bits in the bitmask.
              Note:  giiSetEventMask  is  an  advisory  call.    For   correct
              operation,  the  application  still  needs to pass a restrictive
              event mask to the event reading functions.

RETURN VALUE

       giiSetEventMask, giiAddEventMask and  giiRemoveEventMask  return  0  on
       success or an gii-error(3) code otherwise.

       giiGetEventMask returns the currently set mask.

SEE ALSO

       gii_event_mask(3)