This is an automated email from the ASF dual-hosted git repository.

xiaoxiang781216 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 43920dfa85e9448be3d61c8306061afbae0d457a
Author: Marco Casaroli <[email protected]>
AuthorDate: Tue Nov 17 00:06:11 2026 +0100

    Documentation/os/audio: Say that a full driver queue fails the enqueue.
    
    A lower half can hold only a limited number of enqueued private buffers.
    virtio-snd now fails AUDIOIOC_ENQUEUEBUFFER with -ENOSPC when its
    virtqueue is full.  Say it next to the description of the private
    buffers, and point to the count of AUDIOIOC_GETBUFFERINFO.
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <[email protected]>
---
 Documentation/os/audio/index.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/os/audio/index.rst b/Documentation/os/audio/index.rst
index 12356a90c85..9caf812fdb1 100644
--- a/Documentation/os/audio/index.rst
+++ b/Documentation/os/audio/index.rst
@@ -126,6 +126,10 @@ takes a ``struct audio_buf_desc_s`` and has two distinct 
modes, selected by the
   ``AUDIOIOC_FREEBUFFER``.  On success the ioctl returns
   ``sizeof(struct audio_buf_desc_s)``.
 
+  The lower half can hold only a limited number of enqueued buffers: use the
+  count that ``AUDIOIOC_GETBUFFERINFO`` reports.  virtio-snd fails
+  ``AUDIOIOC_ENQUEUEBUFFER`` with ``-ENOSPC`` when its virtqueue is full.
+
   This is the mode used by ``nxplayer``, ``nxrecorder`` and ``nxlooper``.
 
 **Shared ring buffers** (``u.pbuffer == NULL``)

Reply via email to