SDL_GUID(3type)

SDL_GUID3type

An sdl_guid is a 128-bit identifier for an input device that identifies that device across runs of sdl programs on the same platform.

Usage

#include "SDL3/SDL.h"

typedef struct SDL_GUID { Uint8 data[16]; } SDL_GUID;

Header file

Defined in SDL3/SDL_guid.h

Overview

If the device is detached and then re-attached to a different port, or if the base system is rebooted, the device should still report the same GUID.

GUIDs are as precise as possible but are not guaranteed to distinguish physically distinct but equivalent devices. For example, two game controllers from the same vendor with the same product ID and revision may have the same GUID.

GUIDs may be platform-dependent (i.e., the same device may report different GUIDs on different operating systems).

Availability

This struct 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.