snd_pcm_crea...958_consumer(9)

🎀 NAME 🎀

snd_pcm_create_iec958_consumer — bestie, this is the one that creates consumer format IEC958 channel status ✨ (yes, the whole header of this page got truncated to snd_pcm_crea...958_consumer(9) and it's living in the Kernel API Manual, section 9, we don't talk about it 💀)

---

✨ SYNOPSIS ✨

int snd_pcm_create_iec958_consumer (struct snd_pcm_runtime *runtime , u8
*cs , size_t len );

like, that's the whole vibe check right there 🫶

---

🌸 ARGUMENTS 🌸

• runtime — the pcm runtime structure, and it needs ->rate already filled in, okay? that part's on you 🔥
• cs — the channel status buffer. it has to be at least four bytes, no cap, don't come at it with two 🙈
• len — the length of that channel status buffer, tell it how much room it's working with 💅

---

🦋 DESCRIPTION 🦋

So what it does is: it creates the consumer format channel status data inside cs, up to a maximum size of len, and it matches everything to the parameters of the PCM runtime runtime ✨ it's giving "I read the room and filled in the buffer accordingly."

And here's the cute part: drivers may wish to tweak the contents of the buffer after creation 🌈 so like, it does the main character work and then you can go in and adjust the fit, iykyk 💜

---

⭐ RETURN ⭐

It returns the length of the buffer 🎀 — or a negative error code if something failed 😭 (ngl if you see a negative number, something went wrong, go fix it).

---

👑 SEE ALSO 👑

• Kernel file ./sound/core/pcm_iec958.c — the source, go read it, it's literally right there 🍓
• snd_pcm_create_iec958_consumer_default(9)
• snd_pcm_fill_iec958_consumer(9)
• snd_pcm_fill_iec958_consumer_hw_params(9)
• snd_pcm_create_iec958_consumer_hw_params(9)

the whole friend group, fr fr 🧚

---

lowkey reminder: cs is at least four bytes, runtime->rate must be filled in, and negative return = error. that's the tea 💖

okay that's the page!! this icon ate and left no crumbs 👑 — brought to you from ./sound/core, dated October 2026, mwah 💋🌸