virtio_ctl_msg.h (2343B)
1/* SPDX-License-Identifier: GPL-2.0+ */ 2/* 3 * virtio-snd: Virtio sound device 4 * Copyright (C) 2021 OpenSynergy GmbH 5 */ 6#ifndef VIRTIO_SND_MSG_H 7#define VIRTIO_SND_MSG_H 8 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 message 36 * content is still needed, the caller must additionally to 37 * 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 an 41 * 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 an 47 * 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 */