snd_pcm_stop(9)

💖 NAME 💖

okay bestie, this is snd_pcm_stop(9) from the Kernel API Manual, and it is literally here to try to stop all running streams in the substream group 💅 no cap.

✨ SYNOPSIS ✨

the signature, copied exactly because we do not mess with code:

int snd_pcm_stop (struct snd_pcm_substream *substream , snd_pcm_state_t
state );

🫶 ARGUMENTS 🫶

• substream — the PCM substream instance 🌸
• state — PCM state after stopping the stream ✨

🦋 DESCRIPTION 🦋

so here's the tea: the state of each stream is then changed to the given state unconditionally. no vibe check, no maybe, no “if it feels like it” — it gets set to the state you handed over. 🔥

bestie, this is the important part: unconditionally means unconditionally. the state of each stream is changed to the given state, periodt. 💀

💜 RETURN 💜

• Zero if successful 🎀
• or a negative error code 😭

🌈 SEE ALSO 🌈

Kernel file ./sound/core/pcm_native.c is the spot, and these are the linked besties:

• snd_pcm_stream_lock(9)
• snd_pcm_stream_unlock(9)
• snd_pcm_stream_lock_irq(9)
• snd_pcm_stream_unlock_irq(9)
• snd_pcm_stream_unlock_irqrestore(9)
• snd_pcm_set_state(9)
• snd_pcm_get_state(9)
• snd_pcm_hw_params_choose(9)
• snd_pcm_start(9)
• snd_pcm_drain_done(9)
• snd_pcm_stop_xrun(9)
• snd_pcm_suspend_all(9)
• snd_pcm_prepare(9)
• snd_pcm_kernel_ioctl(9)
• snd_pcm_lib_default_mmap(9)
• snd_pcm_lib_mmap_iomem(9)

mwah 💋 — source/version: ./sound/core; date: October 2026. 🎀