snd_ump_endpoint_new(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

✨ snd_ump_endpoint_new(9) ✨

okay so bestie, this is a page from the Kernel API Manual and it's literally all about making a UMP Endpoint. buckle up, it's giving kernel-core realness πŸ’…


πŸŽ€ NAME πŸŽ€

snd_ump_endpoint_new β€” create a UMP Endpoint object ✨


πŸ¦‹ SYNOPSIS πŸ¦‹

int snd_ump_endpoint_new (struct snd_card *card , char *id , int device
, int output , int input , struct snd_ump_endpoint **ump_ret );

like, that's the whole signature, no cap. six args, go off πŸ‘‘


🌸 ARGUMENTS 🌸

  • card β€” the card instance 🫢
  • id β€” the id string for rawmidi, yep, that's the one 🌈
  • device β€” the device index for rawmidi, keep track bestie πŸ”₯
  • output β€” 1 for enabling output ⭐
  • input β€” 1 for enabling input ⭐
  • ump_ret β€” the pointer where the new UMP instance gets stored, main character pointer energy πŸ’–

πŸ’œ DESCRIPTION πŸ’œ

So this function creates a new UMP Endpoint object. periodt. πŸ’…

A UMP Endpoint is tied with one rawmidi instance that has one input and/or one output rawmidi stream β€” and yes, that can be uni- or bi-directional, both are valid, we love flexibility πŸ¦‹. A UMP Endpoint may also contain one or multiple UMP Blocks, and those Blocks consist of one or multiple UMP Groups. it's giving nested. it's giving hierarchy. iconic honestly 🌸

Now, the important part: use snd_rawmidi_set_ops to set the operators to the new instance. iykyk πŸ‘€

and like β€” unlike snd_rawmidi_new, this function sets up the info_flags by itself depending on the given output and input. so don't come for it about flags, it handles that πŸ™ˆ

The device has the SNDRV_RAWMIDI_INFO_UMP flag set, and a different device file gets created β€” "umpCxDx" instead of the standard MIDI 1.x device file "midiCxDx". two different names, two different vibes, don't mix them up bestie πŸ’€


πŸ“ RETURN πŸ“

Zero if successful, or a negative error code on failure. so basically 0 = slay, negative = not slay 😭


🧚 SEE ALSO 🧚

go read those too, they're all in the same friend group fr fr 🫢


aaaand that's the whole page, bestie πŸ’– this dropped from ./sound/core back in October 2026 β€” so yeah, source + date, all accounted for, and this manual page is now officially closed. mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from