STRUCT WMI_BRIGHTNESS_ARGS(9)

✨ struct wmi_brightness_args(9) ✨

okay bestie, so this whole page is about struct wmi_brightness_args — literally just the arguments struct for the WMI-wrapped ACPI method 💅 it lives in the Kernel API Manual and we're gonna go through it together, no cap.

---

🌸 NAME 🌸

struct wmi_brightness_args — the arguments for the WMI-wrapped ACPI method. that's it, that's the vibe 🫶

---

🦋 SYNOPSIS 🦋

here's the struct in all its iconic glory, copy it exactly bestie:

struct wmi_brightness_args {
    u32 mode;
    u32 val;
    u32 ret;
    u32 ignored[3];
 };

---

🎀 Members 🎀

okay so let's meet the members one by one, they each have a job and they're all main characters in their own way 💖

• mode — you pass in an enum wmi_brightness_mode value here, and it's the thing that picks whether you're getting a value or setting one. the decider, the icon 👑
• val — this is the in parameter, aka the value you wanna set when you're in WMI_BRIGHTNESS_MODE_SET mode. and listen — it's not used in conjunction with WMI_BRIGHTNESS_MODE_GET or WMI_BRIGHTNESS_MODE_GET_MAX_LEVEL mode. so don't try it, bestie 🙈
• ret — the out parameter, it returns the retrieved value when you're operating in WMI_BRIGHTNESS_MODE_GET or WMI_BRIGHTNESS_MODE_GET_MAX_LEVEL mode. not used in WMI_BRIGHTNESS_MODE_SET mode though, she sits that one out 💀
• ignored — literally padding, not used, just vibing there. why? because the ACPI method expects a 24 byte params struct. so she's filler but she's doing it gorgeously ✨

---

🔥 Description 🔥

so what is this whole thing? it's the parameters structure for the WmiBrightnessNotify ACPI method, as wrapped by WMI. periodt 💅

and here's the part you gotta remember, bestie — the value you pass in to val, or the one that comes back out of ret, will be a brightness value when the WMI method ID is WMI_BRIGHTNESS_METHOD_LEVEL 🌈 … OR it'll be an enum wmi_brightness_source value when it's WMI_BRIGHTNESS_METHOD_SOURCE. iykyk 👀

fr fr keep track of which method ID you're in, because the meaning of that number totally switches up on you. no cap.

---

⭐ SEE ALSO ⭐

go peek at these, they're all connected and honestly obsessed with each other 🧚

• Kernel file ./include/linux/platform_data/x86/nvidia-wmi-ec-backlight.h
• enum wmi_brightness_method(9)
• enum wmi_brightness_mode(9)
• enum wmi_brightness_source(9)

---

and that's the whole page, bestie 🎀 this little gem comes from ./include/linux/platform_data/x86, dated October 2026, and it's filed under struct wmi_brightness_args(9). slay, go forth and set some brightness levels 💖✨🦋