---
name: "SDL_GetTouchDevices"
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_GetTouchDevices"
---

# SDL\_GetTouchDevices(3)

Get a list of registered touch devices.

## NAME

SDL\_GetTouchDevices - Get a list of registered touch devices.

## HEADER FILE

Defined in SDL3/SDL\_touch.h

## SYNOPSIS

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

**SDL\_TouchID \* SDL\_GetTouchDevices(int \*count);**

## DESCRIPTION

On some platforms SDL first sees the touch device if it was actually used. Therefore the returned list might be empty, although devices are available. After using all devices at least once the number will be correct.

## FUNCTION PARAMETERS

- *count*

  a pointer filled in with the number of devices returned, may be NULL.

## RETURN VALUE

( **SDL\_TouchID**\
  \*) Returns a 0 terminated array of touch device IDs or NULL on failure; call  **SDL\_GetError** () for more information. This should be freed with  **SDL\_free** () when it is no longer needed.

## AVAILABILITY

This function is available since SDL 3.2.0.