wmi_string_from_utf8s(9)

📦 version 7.3.1, in nixpkgs unstable

✨ wmi_string_from_utf8s(9) ✨

okay bestie, welcome to the Kernel API Manual — today's main character is wmi_string_from_utf8s, and honestly? she's giving "glow-up translator" energy 💅

🎀 NAME 🎀

wmi_string_from_utf8s — literally converts a UTF8 string into a WMI string. no cap, that's the whole gig 🦋

🌸 SYNOPSIS 🌸

ssize_t wmi_string_from_utf8s (struct wmi_string *str , size_t max_chars
, const u8 *src , size_t src_length );

like, look at her signature. so clean. so iconic. ✨

💖 ARGUMENTS 💖

  • str — the WMI string representation, aka where the magic lands 🫶
  • max_chars — the maximum number of UTF16 code points you're allowed to store inside the WMI string. that's her limit, respect it 🚧
  • src — the UTF8 string you're converting (the source, the muse, the blueprint) 🦋
  • src_length — length of the source string, and listen: without any trailing NUL-characters. so don't be counting those, bestie 🙈

🌈 DESCRIPTION 🌈

so here's the vibe check 👑: this function converts a UTF8 string into a WMI string.

the conversion stops when the WMI string is full — no overflow drama, she just knows when to stop 💀

and when this function returns successfully? the resulting WMI string will always be NUL-terminated, and its length field will be set to an appropriate value. always. periodt. 💅

🔥 RETURN 🔥

she hands you back the number of UTF16 code points inside the WMI string 🎀

or, if things go sideways, a negative errno code. 😭 that's the fail state, and yes, it's negative, look out for it.

🧚 SEE ALSO 🧚

okay but seriously bestie, if max_chars is small the string gets cut off — that's not a bug, that's just her stopping when she's full 🍓

mwah, that's the whole page 💜 this lil' slice of kernel docs lives in ./drivers/platform/wmi, dated October 2026 — and it's wmi_string_from_utf8s(9) all the way down, iykyk ⭐🌸

📦 where this page comes from