---
name: "SDL_HINT_HIDAPI_LIBUSB_WHITELIST"
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_LIBUSB_WHITELIST"
---

# SDL\_HINT\_HIDAPI\_LIBUSB\_WHITELIST(3)

A variable to control whether HIDAPI uses libusb only for whitelisted devices.

## NAME

SDL\_HINT\_HIDAPI\_LIBUSB\_WHITELIST - A variable to control whether HIDAPI uses libusb only for whitelisted devices.

## HEADER FILE

Defined in SDL3/SDL\_hints.h

## SYNOPSIS

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

**#define SDL\_HINT\_HIDAPI\_LIBUSB\_WHITELIST** *SDL\_HIDAPI\_LIBUSB\_WHITELIST"*

## DESCRIPTION

By default libusb will only be used for a few devices that require direct USB access.

The variable can be set to the following values:

• "0": HIDAPI will use libusb for all device access.

• "1": HIDAPI will use libusb only for whitelisted devices. (default)

This hint should be set before SDL is initialized.

## AVAILABILITY

This hint is available since SDL 3.2.0.