---
name: "SDL_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS"
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_HINT_HIDAPI_ENUMERATE_ONLY_CONTROLLERS"
---

# SDL\_HINT\_HIDAPI\_ENUMERATE\_ONLY\_CONTROLLERS(3)

A variable to control whether SDL\_hid\_enumerate () enumerates all HID devices or only controllers.

## NAME

SDL\_HINT\_HIDAPI\_ENUMERATE\_ONLY\_CONTROLLERS - A variable to control whether  **SDL\_hid\_enumerate** () enumerates all HID devices or only controllers.

## HEADER FILE

Defined in SDL3/SDL\_hints.h

## SYNOPSIS

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

**#define SDL\_HINT\_HIDAPI\_ENUMERATE\_ONLY\_CONTROLLERS** *SDL\_HIDAPI\_ENUMERATE\_ONLY\_CONTROLLERS"*

## DESCRIPTION

The variable can be set to the following values:

• "0":  **SDL\_hid\_enumerate** () will enumerate all HID\
   devices.

• "1":  **SDL\_hid\_enumerate** () will only enumerate\
   controllers. (default)

By default SDL will only enumerate controllers, to reduce risk of hanging or crashing on devices with bad drivers and avoiding macOS keyboard capture permission prompts.

This hint can be set anytime.

## AVAILABILITY

This hint is available since SDL 3.2.0.