79 lines · c
1/* SPDX-License-Identifier: GPL-2.0+ */2/*3 * virtio-snd: Virtio sound device4 * Copyright (C) 2021 OpenSynergy GmbH5 */6#ifndef VIRTIO_SND_MSG_H7#define VIRTIO_SND_MSG_H8 9#include <linux/atomic.h>10#include <linux/virtio.h>11 12struct virtio_snd;13struct virtio_snd_msg;14 15void virtsnd_ctl_msg_ref(struct virtio_snd_msg *msg);16 17void virtsnd_ctl_msg_unref(struct virtio_snd_msg *msg);18 19void *virtsnd_ctl_msg_request(struct virtio_snd_msg *msg);20 21void *virtsnd_ctl_msg_response(struct virtio_snd_msg *msg);22 23struct virtio_snd_msg *virtsnd_ctl_msg_alloc(size_t request_size,24 size_t response_size, gfp_t gfp);25 26int virtsnd_ctl_msg_send(struct virtio_snd *snd, struct virtio_snd_msg *msg,27 struct scatterlist *out_sgs,28 struct scatterlist *in_sgs, bool nowait);29 30/**31 * virtsnd_ctl_msg_send_sync() - Simplified sending of synchronous message.32 * @snd: VirtIO sound device.33 * @msg: Control message.34 *35 * After returning from this function, the message will be deleted. If message36 * content is still needed, the caller must additionally to37 * virtsnd_ctl_msg_ref/unref() it.38 *39 * The msg_timeout_ms module parameter defines the message completion timeout.40 * If the message is not completed within this time, the function will return an41 * error.42 *43 * Context: Any context that permits to sleep.44 * Return: 0 on success, -errno on failure.45 *46 * The return value is a message status code (VIRTIO_SND_S_XXX) converted to an47 * appropriate -errno value.48 */49static inline int virtsnd_ctl_msg_send_sync(struct virtio_snd *snd,50 struct virtio_snd_msg *msg)51{52 return virtsnd_ctl_msg_send(snd, msg, NULL, NULL, false);53}54 55/**56 * virtsnd_ctl_msg_send_async() - Simplified sending of asynchronous message.57 * @snd: VirtIO sound device.58 * @msg: Control message.59 *60 * Context: Any context.61 * Return: 0 on success, -errno on failure.62 */63static inline int virtsnd_ctl_msg_send_async(struct virtio_snd *snd,64 struct virtio_snd_msg *msg)65{66 return virtsnd_ctl_msg_send(snd, msg, NULL, NULL, true);67}68 69void virtsnd_ctl_msg_cancel_all(struct virtio_snd *snd);70 71void virtsnd_ctl_msg_complete(struct virtio_snd_msg *msg);72 73int virtsnd_ctl_query_info(struct virtio_snd *snd, int command, int start_id,74 int count, size_t size, void *info);75 76void virtsnd_ctl_notify_cb(struct virtqueue *vqueue);77 78#endif /* VIRTIO_SND_MSG_H */79