LXR linux/include/sound/seq

   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 "asequencer.h"
  26
  27typedef struct snd_seq_real_time snd_seq_real_time_t;
  28typedef union snd_seq_timestamp snd_seq_timestamp_t;
  29
  30/* maximum number of events dequeued per schedule interval */
  31#define SNDRV_SEQ_MAX_DEQUEUE           50
  32
  33/* maximum number of queues */
  34#define SNDRV_SEQ_MAX_QUEUES            8
  35
  36/* max number of concurrent clients */
  37#define SNDRV_SEQ_MAX_CLIENTS           192
  38
  39/* max number of concurrent ports */
  40#define SNDRV_SEQ_MAX_PORTS             254
  41
  42/* max number of events in memory pool */
  43#define SNDRV_SEQ_MAX_EVENTS            2000
  44
  45/* default number of events in memory chunk */
  46#define SNDRV_SEQ_DEFAULT_CHUNK_EVENTS  64
  47
  48/* default number of events in memory pool */
  49#define SNDRV_SEQ_DEFAULT_EVENTS        500
  50
  51/* max number of events in memory pool for one client (outqueue) */
  52#define SNDRV_SEQ_MAX_CLIENT_EVENTS     2000
  53
  54/* default number of events in memory pool for one client (outqueue) */
  55#define SNDRV_SEQ_DEFAULT_CLIENT_EVENTS 200
  56
  57/* max delivery path length */
  58#define SNDRV_SEQ_MAX_HOPS              10
  59
  60/* max size of event size */
  61#define SNDRV_SEQ_MAX_EVENT_LEN         0x3fffffff
  62
  63/* call-backs for kernel port */
  64struct snd_seq_port_callback {
  65        struct module *owner;
  66        void *private_data;
  67        int (*subscribe)(void *private_data, struct snd_seq_port_subscribe *info);
  68        int (*unsubscribe)(void *private_data, struct snd_seq_port_subscribe *info);
  69        int (*use)(void *private_data, struct snd_seq_port_subscribe *info);
  70        int (*unuse)(void *private_data, struct snd_seq_port_subscribe *info);
  71        int (*event_input)(struct snd_seq_event *ev, int direct, void *private_data, int atomic, int hop);
  72        void (*private_free)(void *private_data);
  73        unsigned int callback_all;      /* call subscribe callbacks at each connection/disconnection */
  74        /*...*/
  75};
  76
  77/* interface for kernel client */
  78int snd_seq_create_kernel_client(struct snd_card *card, int client_index,
  79                                 const char *name_fmt, ...)
  80        __attribute__ ((format (printf, 3, 4)));
  81int snd_seq_delete_kernel_client(int client);
  82int snd_seq_kernel_client_enqueue(int client, struct snd_seq_event *ev, int atomic, int hop);
  83int snd_seq_kernel_client_dispatch(int client, struct snd_seq_event *ev, int atomic, int hop);
  84int snd_seq_kernel_client_ctl(int client, unsigned int cmd, void *arg);
  85
  86#define SNDRV_SEQ_EXT_MASK      0xc0000000
  87#define SNDRV_SEQ_EXT_USRPTR    0x80000000
  88#define SNDRV_SEQ_EXT_CHAINED   0x40000000
  89
  90typedef int (*snd_seq_dump_func_t)(void *ptr, void *buf, int count);
  91int snd_seq_expand_var_event(const struct snd_seq_event *event, int count, char *buf,
  92                             int in_kernel, int size_aligned);
  93int snd_seq_dump_var_event(const struct snd_seq_event *event,
  94                           snd_seq_dump_func_t func, void *private_data);
  95
  96/* interface for OSS emulation */
  97int snd_seq_set_queue_tempo(int client, struct snd_seq_queue_tempo *tempo);
  98
  99/* port callback routines */
 100void snd_port_init_callback(struct snd_seq_port_callback *p);
 101struct snd_seq_port_callback *snd_port_alloc_callback(void);
 102
 103/* port attach/detach */
 104int snd_seq_event_port_attach(int client, struct snd_seq_port_callback *pcbp,
 105                              int cap, int type, int midi_channels, int midi_voices, char *portname);
 106int snd_seq_event_port_detach(int client, int port);
 107
 108#ifdef CONFIG_MODULES
 109void snd_seq_autoload_lock(void);
 110void snd_seq_autoload_unlock(void);
 111#else
 112#define snd_seq_autoload_lock()
 113#define snd_seq_autoload_unlock()
 114#endif
 115
 116#endif /* __SOUND_SEQ_KERNEL_H */
 117