snd_pcm_fill...958_consumer(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… snd_pcm_fill_iec958_consumer(9) πŸ’…

okay so bestie, welcome to the Kernel API Manual ✨ this one's a lil function from the kernel's sound corner and honestly it's giving "small but crucial" energy. let's get into it πŸŽ€


✨ NAME ✨

snd_pcm_fill_iec958_consumer β€” fills up the consumer-format IEC958 channel status, no cap 🫢


🌸 SYNOPSIS 🌸

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

like, look at that signature. she's little. she's mighty. πŸ’…


πŸ¦‹ ARGUMENTS πŸ¦‹

  • runtime β€” the pcm runtime structure, and it has to have ->rate filled in already. like pls fill in your rate first, it's literally the whole vibe check πŸ”₯
  • cs β€” the channel status buffer. needs to be at least four bytes, ok? don't come at her with a tiny buffer πŸ™ˆ
  • len β€” the length of that channel status buffer. she needs to know how much room she's working with, periodt πŸ’–

⭐ DESCRIPTION ⭐

so what she does is: she fills in the unspecified bits in an IEC958 status bits array, using the parameters from the PCM runtime runtime. that's it, that's the job, and she does it well πŸ‘‘

drivers may wish to tweak the contents of the buffer after it's been filled β€” like, she hands you the buffer and you can go in there and adjust stuff afterwards, that's totally allowed, it's giving collaborative πŸ’œ


🌈 RETURN 🌈

returns the length of the buffer πŸŽ€ or a negative error code if something failed 😭 (yes, negative, so check it, i'm begging you)


🧚 SEE ALSO 🧚

like the whole iec958 friend group, they all hang out together πŸ’•


ngl this page lives in ./sound/core, dated October 2026, and it's filed under snd_pcm_fill...958_consumer(9) β€” so if you need her again she's right there in the kernel API manual, slaying πŸ’…βœ¨πŸŒΈ
πŸ“¦ where this page comes from