control.h 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. #ifndef __SOUND_CONTROL_H
  2. #define __SOUND_CONTROL_H
  3. /*
  4. * Header file for control interface
  5. * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
  6. *
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation; either version 2 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  21. *
  22. */
  23. #include <sound/asound.h>
  24. #define snd_kcontrol_chip(kcontrol) ((kcontrol)->private_data)
  25. struct snd_kcontrol;
  26. typedef int (snd_kcontrol_info_t) (struct snd_kcontrol * kcontrol, struct snd_ctl_elem_info * uinfo);
  27. typedef int (snd_kcontrol_get_t) (struct snd_kcontrol * kcontrol, struct snd_ctl_elem_value * ucontrol);
  28. typedef int (snd_kcontrol_put_t) (struct snd_kcontrol * kcontrol, struct snd_ctl_elem_value * ucontrol);
  29. typedef int (snd_kcontrol_tlv_rw_t)(struct snd_kcontrol *kcontrol,
  30. int op_flag, /* 0=read,1=write,-1=command */
  31. unsigned int size,
  32. unsigned int __user *tlv);
  33. struct snd_kcontrol_new {
  34. snd_ctl_elem_iface_t iface; /* interface identifier */
  35. unsigned int device; /* device/client number */
  36. unsigned int subdevice; /* subdevice (substream) number */
  37. unsigned char *name; /* ASCII name of item */
  38. unsigned int index; /* index of item */
  39. unsigned int access; /* access rights */
  40. unsigned int count; /* count of same elements */
  41. snd_kcontrol_info_t *info;
  42. snd_kcontrol_get_t *get;
  43. snd_kcontrol_put_t *put;
  44. union {
  45. snd_kcontrol_tlv_rw_t *c;
  46. const unsigned int *p;
  47. } tlv;
  48. unsigned long private_value;
  49. };
  50. struct snd_kcontrol_volatile {
  51. struct snd_ctl_file *owner; /* locked */
  52. pid_t owner_pid;
  53. unsigned int access; /* access rights */
  54. };
  55. struct snd_kcontrol {
  56. struct list_head list; /* list of controls */
  57. struct snd_ctl_elem_id id;
  58. unsigned int count; /* count of same elements */
  59. snd_kcontrol_info_t *info;
  60. snd_kcontrol_get_t *get;
  61. snd_kcontrol_put_t *put;
  62. union {
  63. snd_kcontrol_tlv_rw_t *c;
  64. const unsigned int *p;
  65. } tlv;
  66. unsigned long private_value;
  67. void *private_data;
  68. void (*private_free)(struct snd_kcontrol *kcontrol);
  69. struct snd_kcontrol_volatile vd[0]; /* volatile data */
  70. };
  71. #define snd_kcontrol(n) list_entry(n, struct snd_kcontrol, list)
  72. struct snd_kctl_event {
  73. struct list_head list; /* list of events */
  74. struct snd_ctl_elem_id id;
  75. unsigned int mask;
  76. };
  77. #define snd_kctl_event(n) list_entry(n, struct snd_kctl_event, list)
  78. struct snd_ctl_file {
  79. struct list_head list; /* list of all control files */
  80. struct snd_card *card;
  81. pid_t pid;
  82. int prefer_pcm_subdevice;
  83. int prefer_rawmidi_subdevice;
  84. wait_queue_head_t change_sleep;
  85. spinlock_t read_lock;
  86. struct fasync_struct *fasync;
  87. int subscribed; /* read interface is activated */
  88. struct list_head events; /* waiting events for read */
  89. };
  90. #define snd_ctl_file(n) list_entry(n, struct snd_ctl_file, list)
  91. typedef int (*snd_kctl_ioctl_func_t) (struct snd_card * card,
  92. struct snd_ctl_file * control,
  93. unsigned int cmd, unsigned long arg);
  94. void snd_ctl_notify(struct snd_card * card, unsigned int mask, struct snd_ctl_elem_id * id);
  95. struct snd_kcontrol *snd_ctl_new1(const struct snd_kcontrol_new * kcontrolnew, void * private_data);
  96. void snd_ctl_free_one(struct snd_kcontrol * kcontrol);
  97. int snd_ctl_add(struct snd_card * card, struct snd_kcontrol * kcontrol);
  98. int snd_ctl_remove(struct snd_card * card, struct snd_kcontrol * kcontrol);
  99. int snd_ctl_remove_id(struct snd_card * card, struct snd_ctl_elem_id *id);
  100. int snd_ctl_rename_id(struct snd_card * card, struct snd_ctl_elem_id *src_id, struct snd_ctl_elem_id *dst_id);
  101. struct snd_kcontrol *snd_ctl_find_numid(struct snd_card * card, unsigned int numid);
  102. struct snd_kcontrol *snd_ctl_find_id(struct snd_card * card, struct snd_ctl_elem_id *id);
  103. int snd_ctl_create(struct snd_card *card);
  104. int snd_ctl_register_ioctl(snd_kctl_ioctl_func_t fcn);
  105. int snd_ctl_unregister_ioctl(snd_kctl_ioctl_func_t fcn);
  106. #ifdef CONFIG_COMPAT
  107. int snd_ctl_register_ioctl_compat(snd_kctl_ioctl_func_t fcn);
  108. int snd_ctl_unregister_ioctl_compat(snd_kctl_ioctl_func_t fcn);
  109. #else
  110. #define snd_ctl_register_ioctl_compat(fcn)
  111. #define snd_ctl_unregister_ioctl_compat(fcn)
  112. #endif
  113. int snd_ctl_elem_read(struct snd_card *card, struct snd_ctl_elem_value *control);
  114. int snd_ctl_elem_write(struct snd_card *card, struct snd_ctl_file *file, struct snd_ctl_elem_value *control);
  115. static inline unsigned int snd_ctl_get_ioffnum(struct snd_kcontrol *kctl, struct snd_ctl_elem_id *id)
  116. {
  117. return id->numid - kctl->id.numid;
  118. }
  119. static inline unsigned int snd_ctl_get_ioffidx(struct snd_kcontrol *kctl, struct snd_ctl_elem_id *id)
  120. {
  121. return id->index - kctl->id.index;
  122. }
  123. static inline unsigned int snd_ctl_get_ioff(struct snd_kcontrol *kctl, struct snd_ctl_elem_id *id)
  124. {
  125. if (id->numid) {
  126. return snd_ctl_get_ioffnum(kctl, id);
  127. } else {
  128. return snd_ctl_get_ioffidx(kctl, id);
  129. }
  130. }
  131. static inline struct snd_ctl_elem_id *snd_ctl_build_ioff(struct snd_ctl_elem_id *dst_id,
  132. struct snd_kcontrol *src_kctl,
  133. unsigned int offset)
  134. {
  135. *dst_id = src_kctl->id;
  136. dst_id->index += offset;
  137. dst_id->numid += offset;
  138. return dst_id;
  139. }
  140. #endif /* __SOUND_CONTROL_H */