| 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */
|
|---|
| 2 | #ifndef __SOUND_SEQ_DEVICE_H
|
|---|
| 3 | #define __SOUND_SEQ_DEVICE_H
|
|---|
| 4 |
|
|---|
| 5 | /*
|
|---|
| 6 | * ALSA sequencer device management
|
|---|
| 7 | * Copyright (c) 1999 by Takashi Iwai <tiwai@suse.de>
|
|---|
| 8 | */
|
|---|
| 9 |
|
|---|
| 10 | /*
|
|---|
| 11 | * registered device information
|
|---|
| 12 | */
|
|---|
| 13 |
|
|---|
| 14 | struct snd_seq_device {
|
|---|
| 15 | /* device info */
|
|---|
| 16 | struct snd_card *card; /* sound card */
|
|---|
| 17 | int device; /* device number */
|
|---|
| 18 | const char *id; /* driver id */
|
|---|
| 19 | char name[80]; /* device name */
|
|---|
| 20 | int argsize; /* size of the argument */
|
|---|
| 21 | void *driver_data; /* private data for driver */
|
|---|
| 22 | void *private_data; /* private data for the caller */
|
|---|
| 23 | void (*private_free)(struct snd_seq_device *device);
|
|---|
| 24 | struct device dev;
|
|---|
| 25 | };
|
|---|
| 26 |
|
|---|
| 27 | #define to_seq_dev(_dev) \
|
|---|
| 28 | container_of(_dev, struct snd_seq_device, dev)
|
|---|
| 29 |
|
|---|
| 30 | /* sequencer driver */
|
|---|
| 31 |
|
|---|
| 32 | /* driver operators
|
|---|
| 33 | * probe:
|
|---|
| 34 | * Initialize the device with given parameters.
|
|---|
| 35 | * Typically,
|
|---|
| 36 | * 1. call snd_hwdep_new
|
|---|
| 37 | * 2. allocate private data and initialize it
|
|---|
| 38 | * 3. call snd_hwdep_register
|
|---|
| 39 | * 4. store the instance to dev->driver_data pointer.
|
|---|
| 40 | *
|
|---|
| 41 | * remove:
|
|---|
| 42 | * Release the private data.
|
|---|
| 43 | * Typically, call snd_device_free(dev->card, dev->driver_data)
|
|---|
| 44 | */
|
|---|
| 45 | struct snd_seq_driver {
|
|---|
| 46 | struct device_driver driver;
|
|---|
| 47 | char *id;
|
|---|
| 48 | int argsize;
|
|---|
| 49 | };
|
|---|
| 50 |
|
|---|
| 51 | #define to_seq_drv(_drv) \
|
|---|
| 52 | container_of(_drv, struct snd_seq_driver, driver)
|
|---|
| 53 |
|
|---|
| 54 | /*
|
|---|
| 55 | * prototypes
|
|---|
| 56 | */
|
|---|
| 57 | #ifdef CONFIG_MODULES
|
|---|
| 58 | void snd_seq_device_load_drivers(void);
|
|---|
| 59 | #else
|
|---|
| 60 | #define snd_seq_device_load_drivers()
|
|---|
| 61 | #endif
|
|---|
| 62 | int snd_seq_device_new(struct snd_card *card, int device, const char *id,
|
|---|
| 63 | int argsize, struct snd_seq_device **result);
|
|---|
| 64 |
|
|---|
| 65 | #define SNDRV_SEQ_DEVICE_ARGPTR(dev) (void *)((char *)(dev) + sizeof(struct snd_seq_device))
|
|---|
| 66 |
|
|---|
| 67 | int __must_check __snd_seq_driver_register(struct snd_seq_driver *drv,
|
|---|
| 68 | struct module *mod);
|
|---|
| 69 | #define snd_seq_driver_register(drv) \
|
|---|
| 70 | __snd_seq_driver_register(drv, THIS_MODULE)
|
|---|
| 71 | void snd_seq_driver_unregister(struct snd_seq_driver *drv);
|
|---|
| 72 |
|
|---|
| 73 | #define module_snd_seq_driver(drv) \
|
|---|
| 74 | module_driver(drv, snd_seq_driver_register, snd_seq_driver_unregister)
|
|---|
| 75 |
|
|---|
| 76 | /*
|
|---|
| 77 | * id strings for generic devices
|
|---|
| 78 | */
|
|---|
| 79 | #define SNDRV_SEQ_DEV_ID_MIDISYNTH "seq-midi"
|
|---|
| 80 | #define SNDRV_SEQ_DEV_ID_OPL3 "opl3-synth"
|
|---|
| 81 | #define SNDRV_SEQ_DEV_ID_UMP "seq-ump-client"
|
|---|
| 82 |
|
|---|
| 83 | #endif /* __SOUND_SEQ_DEVICE_H */
|
|---|
