SDL_WindowsMessageHook(3type)

SDL_WindowsMessageHook3type

A callback to be used with sdl_setwindowsmessagehook .

Usage

#include "SDL3/SDL.h"

typedef bool (SDLCALL *SDL_WindowsMessageHook)(void *userdata, MSG *msg);

Header file

Defined in SDL3/SDL_system.h

Overview

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

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

Function parameters

userdata

the app-defined pointer provided to SDL_SetWindowsMessageHook .

msg

a pointer to a Win32 event structure 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 Windows event loop.

Availability

This datatype is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.