---
name: "SDL_X11EventHook"
section: "3type"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_X11EventHook"
---

# SDL\_X11EventHook(3type)

A callback to be used with SDL\_SetX11EventHook .

## NAME

SDL\_X11EventHook - A callback to be used with  **SDL\_SetX11EventHook** .

## HEADER FILE

Defined in SDL3/SDL\_system.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**typedef bool (SDLCALL \*SDL\_X11EventHook)(void \*userdata, XEvent \*xevent);**

## DESCRIPTION

This callback may modify the event, and should return true if the event should continue to be processed, or false to prevent further processing.

As this is processing an event directly from the X11 event loop, this callback should do the minimum required work and return quickly.

## FUNCTION PARAMETERS

- *userdata*

  the app-defined pointer provided to  **SDL\_SetX11EventHook** .

- *xevent*

  a pointer to an Xlib XEvent union to process.

## RETURN VALUE

Returns true to let event continue on, false to drop it.

## THREAD SAFETY

This may only be called (by SDL) from the thread handling the X11 event loop.

## AVAILABILITY

This datatype is available since SDL 3.2.0.

## SEE ALSO

**•**(3), [**SDL\_SetX11EventHook**(3)](/SDL_SetX11EventHook/3.md)