virtsnd_pcm_find_or_create(9)

📦 version 7.3.1, in nixpkgs unstable

💖 virtsnd_pcm_find_or_create — the "find it or make it" queen 💖

okay so bestie, welcome to the Kernel API Manual entry for virtsnd_pcm_find_or_create(9) — the function that literally goes "do we already have a PCM device for this node ID? no? bet, making one ✨". It's giving lookup plus creation in one iconic little call, and honestly? We stan a multitasker.

🌸 NAME 🌸

virtsnd_pcm_find_or_create — find or create the PCM device for the specified node ID. that's it, that's the whole vibe 🎀

🦋 SYNOPSIS 🦋

struct virtio_pcm * virtsnd_pcm_find_or_create (struct virtio_snd *snd ,
       u32 nid );

it hands you back a struct virtio_pcm * — a pointer to the PCM device, or an error in disguise (more on that below, don't panic) 💅

✨ ARGUMENTS ✨

  • snd — the VirtIO sound device. like, the actual sound hardware situation you're working with 🎧
  • nid — the function node ID. the little number that says which node we're talking about 🌟

🛌 CONTEXT 🛌

Any context that permits to sleep. yes bestie, sleep is allowed here — so no calling this from somewhere that can't block, m'kay? 😴💤

🎁 RETURN 🎁

a pointer to the PCM device, or ERR_PTR(-errno) if things went sideways 🫶

ngl, always run the vibe check on the return value — IS_ERR() exists for a reason, and unchecked error pointers are not the main character energy you want 💀

👀 SEE ALSO 👀

Kernel file ./sound/virtio/virtio_pcm.c — go read the source, iykyk 🧚

that's the whole friend group fr fr — go say hi 🌈

💖 and that's the page!! 💖 this little gem lives over in ./sound/virtio and the version stamp says October 2026 — so yeah, mark your calendar bestie, the source is ./sound/virtio, the date is October 2026, and virtsnd_pcm_find_or_create(9) is officially slaying in the manual. periodt 🎀🦋✨

📦 where this page comes from