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

# SDL\_SetWindowsMessageHook(3)

Set a callback for every Windows message, run before TranslateMessage().

## NAME

SDL\_SetWindowsMessageHook - Set a callback for every Windows message, run before TranslateMessage().

## HEADER FILE

Defined in SDL3/SDL\_system.h

## SYNOPSIS

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

**void SDL\_SetWindowsMessageHook(SDL\_WindowsMessageHook callback, void \*userdata);**

## DESCRIPTION

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

## FUNCTION PARAMETERS

- *callback*

  the  **SDL\_WindowsMessageHook**\
    function to call.

- *userdata*

  a pointer to pass to every iteration of **callback** .

## AVAILABILITY

This function is available since SDL 3.2.0.

## SEE ALSO

**•**(3), [**SDL\_WindowsMessageHook**(3type)](/SDL_WindowsMessageHook/3type.md), **•**(3), [**SDL\_HINT\_WINDOWS\_ENABLE\_MESSAGELOOP**(3)](/SDL_HINT_WINDOWS_ENABLE_MESSAGELOOP/3.md)