---
name: "giiRemoveEventMask"
section: "3gii"
platform: "linux"
package: "libgii0-dev"
version: "1:0.8.1-1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/giiSetEventMask/3gii"
---

# giiRemoveEventMask(3gii)

Set the types of events queued

Part of [giiSetEventMask(3gii)](/giiSetEventMask/3gii.md).

## 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** *mask***);**

**int giiRemoveEventMask(gii\_input\_t** *inp***, gii\_event\_mask** *mask***);** .SH "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** or **giiEventRead** 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.

**giiGetEventMask** returns the event mask in effect.

**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 error code otherwise.

**giiGetEventMask** returns the currently set mask.