include/sound/seq_kernel.h

   1 #ifndef __SOUND_SEQ_KERNEL_H
   2 #define __SOUND_SEQ_KERNEL_H
   3
   4 /*
   5  *  Main kernel header file for the ALSA sequencer
   6  *  Copyright (c) 1998 by Frank van de Pol <fvdpol@coil.demon.nl>
   7  *
   8  *
   9  *   This program is free software; you can redistribute it and/or modify
  10  *   it under the terms of the GNU General Public License as published by
  11  *   the Free Software Foundation; either version 2 of the License, or
  12  *   (at your option) any later version.
  13  *
  14  *   This program is distributed in the hope that it will be useful,
  15  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  *   GNU General Public License for more details.
  18  *
  19  *   You should have received a copy of the GNU General Public License
  20  *   along with this program; if not, write to the Free Software
  21  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  22  *
  23  */
  24 #include <linux/time.h>
  25 #include <sound/asequencer.h>
  26
  27 typedef struct snd_seq_real_time snd_seq_real_time_t;
  28 typedef union snd_seq_timestamp snd_seq_timestamp_t;
  29
  30 /* maximum number of queues */
  31 #define SNDRV_SEQ_MAX_QUEUES            32
  32
  33 /* max number of concurrent clients */
  34 #define SNDRV_SEQ_MAX_CLIENTS           192
  35
  36 /* max number of concurrent ports */
  37 #define SNDRV_SEQ_MAX_PORTS             254
  38
  39 /* max number of events in memory pool */
  40 #define SNDRV_SEQ_MAX_EVENTS            2000
  41
  42 /* default number of events in memory pool */
  43 #define SNDRV_SEQ_DEFAULT_EVENTS        500
  44
  45 /* max number of events in memory pool for one client (outqueue) */
  46 #define SNDRV_SEQ_MAX_CLIENT_EVENTS     2000
  47
  48 /* default number of events in memory pool for one client (outqueue) */
  49 #define SNDRV_SEQ_DEFAULT_CLIENT_EVENTS 200
  50
  51 /* max delivery path length */
  52 /* NOTE: this shouldn't be greater than MAX_LOCKDEP_SUBCLASSES */
  53 #define SNDRV_SEQ_MAX_HOPS              8
  54
  55 /* max size of event size */
  56 #define SNDRV_SEQ_MAX_EVENT_LEN         0x3fffffff
  57
  58 /* call-backs for kernel port */
  59 struct snd_seq_port_callback {
  60         struct module *owner;
  61         void *private_data;
  62         int (*subscribe)(void *private_data, struct snd_seq_port_subscribe *info);
  63         int (*unsubscribe)(void *private_data, struct snd_seq_port_subscribe *info);
  64         int (*use)(void *private_data, struct snd_seq_port_subscribe *info);
  65         int (*unuse)(void *private_data, struct snd_seq_port_subscribe *info);
  66         int (*event_input)(struct snd_seq_event *ev, int direct, void *private_data, int atomic, int hop);
  67         void (*private_free)(void *private_data);
  68         /*...*/
  69 };
  70
  71 /* interface for kernel client */
  72 __printf(3, 4)
  73 int snd_seq_create_kernel_client(struct snd_card *card, int client_index,
  74                                  const char *name_fmt, ...);
  75 int snd_seq_delete_kernel_client(int client);
  76 int snd_seq_kernel_client_enqueue(int client, struct snd_seq_event *ev, int atomic, int hop);
  77 int snd_seq_kernel_client_dispatch(int client, struct snd_seq_event *ev, int atomic, int hop);
  78 int snd_seq_kernel_client_ctl(int client, unsigned int cmd, void *arg);
  79
  80 #define SNDRV_SEQ_EXT_MASK      0xc0000000
  81 #define SNDRV_SEQ_EXT_USRPTR    0x80000000
  82 #define SNDRV_SEQ_EXT_CHAINED   0x40000000
  83
  84 typedef int (*snd_seq_dump_func_t)(void *ptr, void *buf, int count);
  85 int snd_seq_expand_var_event(const struct snd_seq_event *event, int count, char *buf,
  86                              int in_kernel, int size_aligned);
  87 int snd_seq_dump_var_event(const struct snd_seq_event *event,
  88                            snd_seq_dump_func_t func, void *private_data);
  89
  90 /* interface for OSS emulation */
  91 int snd_seq_set_queue_tempo(int client, struct snd_seq_queue_tempo *tempo);
  92
  93 /* port callback routines */
  94 void snd_port_init_callback(struct snd_seq_port_callback *p);
  95 struct snd_seq_port_callback *snd_port_alloc_callback(void);
  96
  97 /* port attach/detach */
  98 int snd_seq_event_port_attach(int client, struct snd_seq_port_callback *pcbp,
  99                               int cap, int type, int midi_channels, int midi_voices, char *portname);
 100 int snd_seq_event_port_detach(int client, int port);
 101
 102 #ifdef CONFIG_MODULES
 103 void snd_seq_autoload_init(void);
 104 void snd_seq_autoload_exit(void);
 105 #else
 106 #define snd_seq_autoload_init()
 107 #define snd_seq_autoload_exit()
 108 #endif
 109
 110 #endif /* __SOUND_SEQ_KERNEL_H */