sound/core/seq/seq_clientmgr.h

   1 /*
   2  *   ALSA sequencer Client Manager
   3  *   Copyright (c) 1998-1999 by Frank van de Pol <fvdpol@coil.demon.nl>
   4  *
   5  *
   6  *   This program is free software; you can redistribute it and/or modify
   7  *   it under the terms of the GNU General Public License as published by
   8  *   the Free Software Foundation; either version 2 of the License, or
   9  *   (at your option) any later version.
  10  *
  11  *   This program is distributed in the hope that it will be useful,
  12  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *   GNU General Public License for more details.
  15  *
  16  *   You should have received a copy of the GNU General Public License
  17  *   along with this program; if not, write to the Free Software
  18  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  19  *
  20  */
  21 #ifndef __SND_SEQ_CLIENTMGR_H
  22 #define __SND_SEQ_CLIENTMGR_H
  23
  24 #include <sound/seq_kernel.h>
  25 #include <linux/bitops.h>
  26 #include "seq_fifo.h"
  27 #include "seq_ports.h"
  28 #include "seq_lock.h"
  29
  30
  31 /* client manager */
  32
  33 struct snd_seq_user_client {
  34         struct file *file;      /* file struct of client */
  35         /* ... */
  36
  37         /* fifo */
  38         struct snd_seq_fifo *fifo;      /* queue for incoming events */
  39         int fifo_pool_size;
  40 };
  41
  42 struct snd_seq_kernel_client {
  43         struct snd_card *card;
  44         /* pointer to client functions */
  45         void *private_data;                     /* private data for client */
  46         /* ... */
  47 };
  48
  49
  50 struct snd_seq_client {
  51         snd_seq_client_type_t type;
  52         unsigned int accept_input: 1,
  53                 accept_output: 1;
  54         char name[64];          /* client name */
  55         int number;             /* client number */
  56         unsigned int filter;    /* filter flags */
  57         DECLARE_BITMAP(event_filter, 256);
  58         snd_use_lock_t use_lock;
  59         int event_lost;
  60         /* ports */
  61         int num_ports;          /* number of ports */
  62         struct list_head ports_list_head;
  63         rwlock_t ports_lock;
  64         struct semaphore ports_mutex;
  65         int convert32;          /* convert 32->64bit */
  66
  67         /* output pool */
  68         struct snd_seq_pool *pool;              /* memory pool for this client */
  69
  70         union {
  71                 struct snd_seq_user_client user;
  72                 struct snd_seq_kernel_client kernel;
  73         } data;
  74 };
  75
  76 /* usage statistics */
  77 struct snd_seq_usage {
  78         int cur;
  79         int peak;
  80 };
  81
  82
  83 int client_init_data(void);
  84 int snd_sequencer_device_init(void);
  85 void snd_sequencer_device_done(void);
  86
  87 /* get locked pointer to client */
  88 struct snd_seq_client *snd_seq_client_use_ptr(int clientid);
  89
  90 /* unlock pointer to client */
  91 #define snd_seq_client_unlock(client) snd_use_lock_free(&(client)->use_lock)
  92
  93 /* dispatch event to client(s) */
  94 int snd_seq_dispatch_event(struct snd_seq_event_cell *cell, int atomic, int hop);
  95
  96 /* exported to other modules */
  97 int snd_seq_register_kernel_client(struct snd_seq_client_callback *callback, void *private_data);
  98 int snd_seq_unregister_kernel_client(int client);
  99 int snd_seq_kernel_client_enqueue(int client, struct snd_seq_event *ev, int atomic, int hop);
 100 int snd_seq_kernel_client_enqueue_blocking(int client, struct snd_seq_event * ev,
 101                                            struct file *file, int atomic, int hop);
 102 int snd_seq_kernel_client_write_poll(int clientid, struct file *file, poll_table *wait);
 103 int snd_seq_client_notify_subscription(int client, int port,
 104                                        struct snd_seq_port_subscribe *info, int evtype);
 105
 106 #endif