1 /* 2 * QEMU Audio subsystem header 3 * 4 * Copyright (c) 2003-2005 Vassili Karpov (malc) 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to deal 8 * in the Software without restriction, including without limitation the rights 9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 10 * copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 22 * THE SOFTWARE. 23 */ 24 #ifndef QEMU_AUDIO_INT_H 25 #define QEMU_AUDIO_INT_H 26 27 #include "audio/audio.h" 28 29 #ifdef CONFIG_COREAUDIO 30 #define FLOAT_MIXENG 31 /* #define RECIPROCAL */ 32 #endif 33 #include "mixeng.h" 34 35 struct audio_pcm_ops; 36 37 typedef enum { 38 AUD_OPT_INT, 39 AUD_OPT_FMT, 40 AUD_OPT_STR, 41 AUD_OPT_BOOL 42 } audio_option_tag_e; 43 44 struct audio_option { 45 const char *name; 46 audio_option_tag_e tag; 47 void *valp; 48 const char *descr; 49 int *overriddenp; 50 int overridden; 51 }; 52 53 struct audio_callback { 54 void *opaque; 55 audio_callback_fn fn; 56 }; 57 58 struct audio_pcm_info { 59 int bits; 60 int sign; 61 int freq; 62 int nchannels; 63 int align; 64 int shift; 65 int bytes_per_second; 66 int swap_endianness; 67 }; 68 69 typedef struct SWVoiceCap SWVoiceCap; 70 71 typedef struct HWVoiceOut { 72 int enabled; 73 int pending_disable; 74 struct audio_pcm_info info; 75 76 f_sample *clip; 77 78 int rpos; 79 uint64_t ts_helper; 80 81 struct st_sample *mix_buf; 82 83 int samples; 84 QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head; 85 QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head; 86 struct audio_pcm_ops *pcm_ops; 87 QLIST_ENTRY (HWVoiceOut) entries; 88 } HWVoiceOut; 89 90 typedef struct HWVoiceIn { 91 int enabled; 92 struct audio_pcm_info info; 93 94 t_sample *conv; 95 96 int wpos; 97 int total_samples_captured; 98 uint64_t ts_helper; 99 100 struct st_sample *conv_buf; 101 102 int samples; 103 QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head; 104 struct audio_pcm_ops *pcm_ops; 105 QLIST_ENTRY (HWVoiceIn) entries; 106 } HWVoiceIn; 107 108 struct SWVoiceOut { 109 QEMUSoundCard *card; 110 struct audio_pcm_info info; 111 t_sample *conv; 112 int64_t ratio; 113 struct st_sample *buf; 114 void *rate; 115 int total_hw_samples_mixed; 116 int active; 117 int empty; 118 HWVoiceOut *hw; 119 char *name; 120 struct mixeng_volume vol; 121 struct audio_callback callback; 122 QLIST_ENTRY (SWVoiceOut) entries; 123 }; 124 125 struct SWVoiceIn { 126 QEMUSoundCard *card; 127 int active; 128 struct audio_pcm_info info; 129 int64_t ratio; 130 void *rate; 131 int total_hw_samples_acquired; 132 struct st_sample *buf; 133 f_sample *clip; 134 HWVoiceIn *hw; 135 char *name; 136 struct mixeng_volume vol; 137 struct audio_callback callback; 138 QLIST_ENTRY (SWVoiceIn) entries; 139 }; 140 141 struct audio_driver { 142 const char *name; 143 const char *descr; 144 struct audio_option *options; 145 void *(*init) (void); 146 void (*fini) (void *); 147 struct audio_pcm_ops *pcm_ops; 148 int can_be_default; 149 int max_voices_out; 150 int max_voices_in; 151 int voice_size_out; 152 int voice_size_in; 153 }; 154 155 struct audio_pcm_ops { 156 int (*init_out)(HWVoiceOut *hw, struct audsettings *as); 157 void (*fini_out)(HWVoiceOut *hw); 158 int (*run_out) (HWVoiceOut *hw); 159 int (*write) (SWVoiceOut *sw, void *buf, int size); 160 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...); 161 162 int (*init_in) (HWVoiceIn *hw, struct audsettings *as); 163 void (*fini_in) (HWVoiceIn *hw); 164 int (*run_in) (HWVoiceIn *hw); 165 int (*read) (SWVoiceIn *sw, void *buf, int size); 166 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...); 167 }; 168 169 struct capture_callback { 170 struct audio_capture_ops ops; 171 void *opaque; 172 QLIST_ENTRY (capture_callback) entries; 173 }; 174 175 struct CaptureVoiceOut { 176 HWVoiceOut hw; 177 void *buf; 178 QLIST_HEAD (cb_listhead, capture_callback) cb_head; 179 QLIST_ENTRY (CaptureVoiceOut) entries; 180 }; 181 182 struct SWVoiceCap { 183 SWVoiceOut sw; 184 CaptureVoiceOut *cap; 185 QLIST_ENTRY (SWVoiceCap) entries; 186 }; 187 188 struct AudioState { 189 struct audio_driver* drv_in; 190 void* drv_in_opaque; 191 struct audio_driver* drv_out; 192 void* drv_out_opaque; 193 194 QEMUTimer *ts; 195 QLIST_HEAD (card_listhead, QEMUSoundCard) card_head; 196 QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in; 197 QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out; 198 QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head; 199 int nb_hw_voices_out; 200 int nb_hw_voices_in; 201 int vm_running; 202 }; 203 204 extern struct audio_driver no_audio_driver; 205 extern struct audio_driver oss_audio_driver; 206 extern struct audio_driver win_audio_driver; 207 extern struct audio_driver wav_audio_driver; 208 extern struct audio_driver fmod_audio_driver; 209 extern struct audio_driver alsa_audio_driver; 210 extern struct audio_driver coreaudio_audio_driver; 211 extern struct audio_driver dsound_audio_driver; 212 extern struct audio_driver esd_audio_driver; 213 extern struct audio_driver pa_audio_driver; 214 extern struct mixeng_volume nominal_volume; 215 216 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as); 217 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len); 218 219 int audio_pcm_sw_write (SWVoiceOut *sw, void *buf, int len); 220 int audio_pcm_hw_get_live_in (HWVoiceIn *hw); 221 222 int audio_pcm_sw_read (SWVoiceIn *sw, void *buf, int len); 223 int audio_pcm_hw_get_live_out (HWVoiceOut *hw); 224 int audio_pcm_hw_get_live_out2 (HWVoiceOut *hw, int *nb_live); 225 226 int audio_bug (const char *funcname, int cond); 227 void *audio_calloc (const char *funcname, int nmemb, size_t size); 228 229 #define VOICE_ENABLE 1 230 #define VOICE_DISABLE 2 231 232 static inline int audio_ring_dist (int dst, int src, int len) 233 { 234 return (dst >= src) ? (dst - src) : (len - src + dst); 235 } 236 237 #if defined __GNUC__ 238 #define GCC_ATTR __attribute__ ((__unused__, __format__ (__printf__, 1, 2))) 239 #define INIT_FIELD(f) . f 240 #define GCC_FMT_ATTR(n, m) __attribute__ ((__format__ (__printf__, n, m))) 241 #else 242 #define GCC_ATTR /**/ 243 #define INIT_FIELD(f) /**/ 244 #define GCC_FMT_ATTR(n, m) 245 #endif 246 247 static void GCC_ATTR dolog (const char *fmt, ...) 248 { 249 va_list ap; 250 251 va_start (ap, fmt); 252 AUD_vlog (AUDIO_CAP, fmt, ap); 253 va_end (ap); 254 } 255 256 #ifdef DEBUG 257 static void GCC_ATTR ldebug (const char *fmt, ...) 258 { 259 va_list ap; 260 261 va_start (ap, fmt); 262 AUD_vlog (AUDIO_CAP, fmt, ap); 263 va_end (ap); 264 } 265 #else 266 #if defined NDEBUG && defined __GNUC__ 267 #define ldebug(...) 268 #elif defined NDEBUG && defined _MSC_VER 269 #define ldebug __noop 270 #else 271 static void GCC_ATTR ldebug (const char *fmt, ...) 272 { 273 (void) fmt; 274 } 275 #endif 276 #endif 277 278 #undef GCC_ATTR 279 280 #define AUDIO_STRINGIFY_(n) #n 281 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n) 282 283 #if defined _MSC_VER || defined __GNUC__ 284 #define AUDIO_FUNC __FUNCTION__ 285 #else 286 #define AUDIO_FUNC __FILE__ ":" AUDIO_STRINGIFY (__LINE__) 287 #endif 288 289 #endif /* audio_int.h */ 290