SDL_HINT_JOY...HIDAPI_SHIELD(3)

🎀 NAME 🎀

SDL_HINT_JOYSTICK_HIDAPI_SHIELD — bestie, this is the little variable that decides whether the HIDAPI driver for NVIDIA SHIELD controllers gets to show up to the party or not. 👑

This page lives in the SDL3 FUNCTIONS manual, under SDL_HINT_JOY...HIDAPI_SHIELD(3). iykyk.

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_HIDAPI_SHIELD "SDL_JOYSTICK_HIDAPI_SHIELD"

literally just one include and one define, we love a low-effort queen 💅

---

💖 DESCRIPTION 💖

okay so here's the vibe: you can set this variable to a couple of different values, and each one does a thing. 🌸

• "0" — the HIDAPI driver is not used. she's sitting this one out, respectfully. 🙈
• "1" — the HIDAPI driver is used. she's here, she's ready, main character energy. 🔥

the default is the value of SDL_HINT_JOYSTICK_HIDAPI — so if you never touch this one, it just copies whatever that other hint says. matching outfits fr fr. 🫶

⚠️ important bestie!! this hint should be set before initializing joysticks and gamepads. setting it after is giving too-late energy and it will not do the thing. 😭

---

🌈 AVAILABILITY 🌈

this hint has been around since SDL 3.2.0. vintage but not vintage vintage, yk? ✨

---

and that's the whole page, no notes, ate and left no crumbs 💅

Simple Directmedia Layer · SDL 3.4.18 · SDL_HINT_JOY...HIDAPI_SHIELD(3) — mwah, go forth and configure ur controller bestie 🎀🦋💜