]> git.alsa-project.org Git - alsa-lib.git/commitdiff
rawmidi: doc - fix the framing / read mode section
authorJaroslav Kysela <perex@perex.cz>
Wed, 22 Sep 2021 09:13:57 +0000 (11:13 +0200)
committerJaroslav Kysela <perex@perex.cz>
Thu, 28 Oct 2021 06:40:20 +0000 (08:40 +0200)
Follow the previous changes and describe the current API.

Signed-off-by: Jaroslav Kysela <perex@perex.cz>
src/rawmidi/rawmidi.c

index 31845e6f1ddd8f5b06a1d4923cd080d8c0e930d8..9fab63f1e2285b1e288c8bb3b80edde8aead41b3 100644 (file)
@@ -118,14 +118,14 @@ hw:soundwave,1,2
 hw:DEV=1,CARD=soundwave,SUBDEV=2
 \endcode
 
-\section rawmidi_framing Framing of rawmidi data
+\section read_mode Read mode
 
-Optionally, incoming rawmidi bytes can be put inside a frame of type snd_rawmidi_framing_tstamp_t.
-The main current benefit is that can enable in-kernel timestamping of incoming bytes, and that
-timestamp is likely to be more precise than what userspace can offer.
+Optionally, incoming rawmidi bytes can be marked with timestamps. The library hides
+the kernel implementation (linux kernel 5.14+) and exports
+the \link ::snd_rawmidi_tread() \endlink  function which returns the
+midi bytes marked with the identical timestamp in one iteration.
 
-Tstamp type framing requires a kernel >= 5.14 and a buffer size that is a multiple of
-sizeof(snd_rawmidi_framing_tstamp_t). It is only available on input streams.
+The timestamping is available only on input streams.
 
 \section rawmidi_examples Examples