/* SPDX-License-Identifier: GPL-2.0-or-later *//* *   ALSA sequencer Client Manager *   Copyright (c) 1998-1999 by Frank van de Pol <fvdpol@coil.demon.nl> */#ifndef __SND_SEQ_CLIENTMGR_H#define __SND_SEQ_CLIENTMGR_H #include <sound/seq_kernel.h>#include <linux/bitops.h>#include "seq_fifo.h"#include "seq_ports.h"#include "seq_lock.h" /* client manager */ #define SND_SEQ_GROUP_FILTER_MASK	GENMASK(SNDRV_UMP_MAX_GROUPS, 0)#define SND_SEQ_GROUP_FILTER_GROUPS	GENMASK(SNDRV_UMP_MAX_GROUPS, 1) struct snd_seq_user_client {	struct file *file;	/* file struct of client */	/* ... */	struct pid *owner;		/* fifo */	struct snd_seq_fifo *fifo;	/* queue for incoming events */	int fifo_pool_size;}; struct snd_seq_kernel_client {	/* ... */	struct snd_card *card;};  struct snd_seq_client {	snd_seq_client_type_t type;	unsigned int accept_input: 1,		accept_output: 1;	unsigned int midi_version;	unsigned int user_pversion;	char name[64];		/* client name */	int number;		/* client number */	unsigned int filter;	/* filter flags */	DECLARE_BITMAP(event_filter, 256);	unsigned int group_filter;	snd_use_lock_t use_lock;	int event_lost;	/* ports */	int num_ports;		/* number of ports */	struct list_head ports_list_head;	struct mutex ports_mutex;	struct mutex ioctl_mutex;	int convert32;		/* convert 32->64bit */	int ump_endpoint_port; 	/* output pool */	struct snd_seq_pool *pool;		/* memory pool for this client */ 	union {		struct snd_seq_user_client user;		struct snd_seq_kernel_client kernel;	} data; 	/* for UMP */	void **ump_info;}; /* usage statistics */struct snd_seq_usage {	int cur;	int peak;};  int client_init_data(void);int snd_sequencer_device_init(void);void snd_sequencer_device_done(void); /* get locked pointer to client */struct snd_seq_client *snd_seq_client_use_ptr(int clientid); static inline struct snd_seq_client *snd_seq_client_ref(struct snd_seq_client *client){	snd_use_lock_use(&client->use_lock);	return client;} /* unlock pointer to client */static inline void snd_seq_client_unref(struct snd_seq_client *client){	snd_use_lock_free(&client->use_lock);} DEFINE_FREE(snd_seq_client, struct snd_seq_client *, if (!IS_ERR_OR_NULL(_T)) snd_seq_client_unref(_T)) /* dispatch event to client(s) */int snd_seq_dispatch_event(struct snd_seq_event_cell *cell, int atomic, int hop); int snd_seq_kernel_client_write_poll(int clientid, struct file *file, poll_table *wait);int snd_seq_client_notify_subscription(int client, int port,				       struct snd_seq_port_subscribe *info, int evtype); int __snd_seq_deliver_single_event(struct snd_seq_client *dest,				   struct snd_seq_client_port *dest_port,				   struct snd_seq_event *event,				   int atomic, int hop); /* only for OSS sequencer */int snd_seq_kernel_client_ioctl(int clientid, unsigned int cmd, void *arg); extern int seq_client_load[15]; /* for internal use between kernel sequencer clients */struct snd_seq_client *snd_seq_kernel_client_get(int client);void snd_seq_kernel_client_put(struct snd_seq_client *cptr); static inline bool snd_seq_client_is_ump(struct snd_seq_client *c){	return c->midi_version != SNDRV_SEQ_CLIENT_LEGACY_MIDI;} static inline bool snd_seq_client_is_midi2(struct snd_seq_client *c){	return c->midi_version == SNDRV_SEQ_CLIENT_UMP_MIDI_2_0;} #endif