mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-26 10:49:33 +00:00
![Takashi Iwai](/assets/img/avatar_default.png)
This patch moves the driver object initialization and allocation to each driver's module init/exit code like other normal drivers. The snd_seq_driver struct is now published in seq_device.h, and each driver is responsible to define it with proper driver attributes (name, probe and remove) with snd_seq_driver specific attributes as id and argsize fields. The helper functions snd_seq_driver_register(), snd_seq_driver_unregister() and module_snd_seq_driver() are used for simplifying codes. Signed-off-by: Takashi Iwai <tiwai@suse.de>
96 lines
2.8 KiB
C
96 lines
2.8 KiB
C
#ifndef __SOUND_SEQ_DEVICE_H
|
|
#define __SOUND_SEQ_DEVICE_H
|
|
|
|
/*
|
|
* ALSA sequencer device management
|
|
* Copyright (c) 1999 by Takashi Iwai <tiwai@suse.de>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* registered device information
|
|
*/
|
|
|
|
struct snd_seq_device {
|
|
/* device info */
|
|
struct snd_card *card; /* sound card */
|
|
int device; /* device number */
|
|
const char *id; /* driver id */
|
|
char name[80]; /* device name */
|
|
int argsize; /* size of the argument */
|
|
void *driver_data; /* private data for driver */
|
|
void *private_data; /* private data for the caller */
|
|
void (*private_free)(struct snd_seq_device *device);
|
|
struct device dev;
|
|
};
|
|
|
|
#define to_seq_dev(_dev) \
|
|
container_of(_dev, struct snd_seq_device, dev)
|
|
|
|
/* sequencer driver */
|
|
|
|
/* driver operators
|
|
* probe:
|
|
* Initialize the device with given parameters.
|
|
* Typically,
|
|
* 1. call snd_hwdep_new
|
|
* 2. allocate private data and initialize it
|
|
* 3. call snd_hwdep_register
|
|
* 4. store the instance to dev->driver_data pointer.
|
|
*
|
|
* remove:
|
|
* Release the private data.
|
|
* Typically, call snd_device_free(dev->card, dev->driver_data)
|
|
*/
|
|
struct snd_seq_driver {
|
|
struct device_driver driver;
|
|
char *id;
|
|
int argsize;
|
|
};
|
|
|
|
#define to_seq_drv(_drv) \
|
|
container_of(_drv, struct snd_seq_driver, driver)
|
|
|
|
/*
|
|
* prototypes
|
|
*/
|
|
#ifdef CONFIG_MODULES
|
|
void snd_seq_device_load_drivers(void);
|
|
#else
|
|
#define snd_seq_device_load_drivers()
|
|
#endif
|
|
int snd_seq_device_new(struct snd_card *card, int device, const char *id,
|
|
int argsize, struct snd_seq_device **result);
|
|
|
|
#define SNDRV_SEQ_DEVICE_ARGPTR(dev) (void *)((char *)(dev) + sizeof(struct snd_seq_device))
|
|
|
|
int __must_check __snd_seq_driver_register(struct snd_seq_driver *drv,
|
|
struct module *mod);
|
|
#define snd_seq_driver_register(drv) \
|
|
__snd_seq_driver_register(drv, THIS_MODULE)
|
|
void snd_seq_driver_unregister(struct snd_seq_driver *drv);
|
|
|
|
#define module_snd_seq_driver(drv) \
|
|
module_driver(drv, snd_seq_driver_register, snd_seq_driver_unregister)
|
|
|
|
/*
|
|
* id strings for generic devices
|
|
*/
|
|
#define SNDRV_SEQ_DEV_ID_MIDISYNTH "seq-midi"
|
|
#define SNDRV_SEQ_DEV_ID_OPL3 "opl3-synth"
|
|
|
|
#endif /* __SOUND_SEQ_DEVICE_H */
|