From: Kai Vehmanen Date: Fri, 29 May 2020 12:28:16 +0000 (+0300) Subject: pcm: add documentation for -ENODATA error code X-Git-Tag: v1.2.3~16 X-Git-Url: https://git.alsa-project.org/?a=commitdiff_plain;h=275409fee3452e110fd4e21a1f0dadf4923c1d6e;p=alsa-lib.git pcm: add documentation for -ENODATA error code This error code can be used e.g. with echo reference PCM devices (the SND_USE_CASE_MOD_ECHO_REF UCM token). Signed-off-by: Kai Vehmanen --- diff --git a/src/pcm/pcm.c b/src/pcm/pcm.c index 98b5ced4..45e791b7 100644 --- a/src/pcm/pcm.c +++ b/src/pcm/pcm.c @@ -292,6 +292,14 @@ This error can happen when device is physically removed (for example some hotplug devices like USB or PCMCIA, CardBus or ExpressCard can be removed on the fly). +\par -ENODATA + +This error can happen if the device data transfer is dependent on +an external condition and that condition is not met. For example, +PCM device for echo reference as described by SND_USE_CASE_MOD_ECHO_REF +UCM token, may return -ENODATA if the linked playback stream has not been +started. + \section pcm_params Managing parameters The ALSA PCM device uses two groups of PCM related parameters. The hardware