]> git.ipfire.org Git - thirdparty/linux.git/commit
virtio_snd.h: clarify that `controls` depends on VIRTIO_SND_F_CTLS
authorStefano Garzarella <sgarzare@redhat.com>
Thu, 13 Feb 2025 16:18:25 +0000 (17:18 +0100)
committerTakashi Iwai <tiwai@suse.de>
Fri, 14 Feb 2025 11:58:02 +0000 (12:58 +0100)
commit362ff1e7c6c20f8d6ebe20682870d471373c608b
tree6d8f3c6f68aa5ea838107bd4c7837e28c2be73b5
parent822b7ec657e99b44b874e052d8540d8b54fe8569
virtio_snd.h: clarify that `controls` depends on VIRTIO_SND_F_CTLS

As defined in the specification, the `controls` field in the configuration
space is only valid/present if VIRTIO_SND_F_CTLS is negotiated.

  From https://docs.oasis-open.org/virtio/virtio/v1.3/virtio-v1.3.html:

  5.14.4 Device Configuration Layout
    ...
    controls
       (driver-read-only) indicates a total number of all available control
       elements if VIRTIO_SND_F_CTLS has been negotiated.

Let's use the same style used in virtio_blk.h to clarify this and to avoid
confusion as happened in QEMU (see link).

Link: https://gitlab.com/qemu-project/qemu/-/issues/2805
Signed-off-by: Stefano Garzarella <sgarzare@redhat.com>
Acked-by: Eugenio Pérez <eperezma@redhat.com>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
Link: https://patch.msgid.link/20250213161825.139952-1-sgarzare@redhat.com
include/uapi/linux/virtio_snd.h