2 * QEMU Audio subsystem header
4 * Copyright (c) 2003-2005 Vassili Karpov (malc)
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:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
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
25 #ifndef QEMU_AUDIO_INT_H
26 #define QEMU_AUDIO_INT_H
28 #ifdef CONFIG_AUDIO_COREAUDIO
30 /* #define RECIPROCAL */
36 struct audio_callback
{
41 struct audio_pcm_info
{
52 typedef struct AudioState AudioState
;
53 typedef struct SWVoiceCap SWVoiceCap
;
55 typedef struct HWVoiceOut
{
60 struct audio_pcm_info info
;
67 struct st_sample
*mix_buf
;
70 QLIST_HEAD (sw_out_listhead
, SWVoiceOut
) sw_head
;
71 QLIST_HEAD (sw_cap_listhead
, SWVoiceCap
) cap_head
;
73 struct audio_pcm_ops
*pcm_ops
;
74 QLIST_ENTRY (HWVoiceOut
) entries
;
77 typedef struct HWVoiceIn
{
81 struct audio_pcm_info info
;
86 int total_samples_captured
;
89 struct st_sample
*conv_buf
;
92 QLIST_HEAD (sw_in_listhead
, SWVoiceIn
) sw_head
;
94 struct audio_pcm_ops
*pcm_ops
;
95 QLIST_ENTRY (HWVoiceIn
) entries
;
101 struct audio_pcm_info info
;
104 struct st_sample
*buf
;
106 int total_hw_samples_mixed
;
111 struct mixeng_volume vol
;
112 struct audio_callback callback
;
113 QLIST_ENTRY (SWVoiceOut
) entries
;
120 struct audio_pcm_info info
;
123 int total_hw_samples_acquired
;
124 struct st_sample
*buf
;
128 struct mixeng_volume vol
;
129 struct audio_callback callback
;
130 QLIST_ENTRY (SWVoiceIn
) entries
;
133 typedef struct audio_driver audio_driver
;
134 struct audio_driver
{
137 void *(*init
) (Audiodev
*);
138 void (*fini
) (void *);
139 struct audio_pcm_ops
*pcm_ops
;
146 QLIST_ENTRY(audio_driver
) next
;
149 struct audio_pcm_ops
{
150 int (*init_out
)(HWVoiceOut
*hw
, struct audsettings
*as
, void *drv_opaque
);
151 void (*fini_out
)(HWVoiceOut
*hw
);
152 int (*run_out
) (HWVoiceOut
*hw
, int live
);
153 int (*write
) (SWVoiceOut
*sw
, void *buf
, int size
);
154 int (*ctl_out
) (HWVoiceOut
*hw
, int cmd
, ...);
156 int (*init_in
) (HWVoiceIn
*hw
, struct audsettings
*as
, void *drv_opaque
);
157 void (*fini_in
) (HWVoiceIn
*hw
);
158 int (*run_in
) (HWVoiceIn
*hw
);
159 int (*read
) (SWVoiceIn
*sw
, void *buf
, int size
);
160 int (*ctl_in
) (HWVoiceIn
*hw
, int cmd
, ...);
163 struct capture_callback
{
164 struct audio_capture_ops ops
;
166 QLIST_ENTRY (capture_callback
) entries
;
169 struct CaptureVoiceOut
{
172 QLIST_HEAD (cb_listhead
, capture_callback
) cb_head
;
173 QLIST_ENTRY (CaptureVoiceOut
) entries
;
178 CaptureVoiceOut
*cap
;
179 QLIST_ENTRY (SWVoiceCap
) entries
;
182 typedef struct AudioState
{
183 struct audio_driver
*drv
;
188 QLIST_HEAD (card_listhead
, QEMUSoundCard
) card_head
;
189 QLIST_HEAD (hw_in_listhead
, HWVoiceIn
) hw_head_in
;
190 QLIST_HEAD (hw_out_listhead
, HWVoiceOut
) hw_head_out
;
191 QLIST_HEAD (cap_listhead
, CaptureVoiceOut
) cap_head
;
192 int nb_hw_voices_out
;
195 int64_t period_ticks
;
200 QTAILQ_ENTRY(AudioState
) list
;
203 extern const struct mixeng_volume nominal_volume
;
205 extern const char *audio_prio_list
[];
207 void audio_driver_register(audio_driver
*drv
);
208 audio_driver
*audio_driver_lookup(const char *name
);
210 void audio_pcm_init_info (struct audio_pcm_info
*info
, struct audsettings
*as
);
211 void audio_pcm_info_clear_buf (struct audio_pcm_info
*info
, void *buf
, int len
);
213 int audio_pcm_sw_write (SWVoiceOut
*sw
, void *buf
, int len
);
214 int audio_pcm_hw_get_live_in (HWVoiceIn
*hw
);
216 int audio_pcm_sw_read (SWVoiceIn
*sw
, void *buf
, int len
);
218 int audio_pcm_hw_clip_out (HWVoiceOut
*hw
, void *pcm_buf
,
219 int live
, int pending
);
221 int audio_bug (const char *funcname
, int cond
);
222 void *audio_calloc (const char *funcname
, int nmemb
, size_t size
);
224 void audio_run(AudioState
*s
, const char *msg
);
226 #define VOICE_ENABLE 1
227 #define VOICE_DISABLE 2
228 #define VOICE_VOLUME 3
230 #define VOICE_VOLUME_CAP (1 << VOICE_VOLUME)
232 static inline int audio_ring_dist (int dst
, int src
, int len
)
234 return (dst
>= src
) ? (dst
- src
) : (len
- src
+ dst
);
237 #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
240 #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
242 #define ldebug(fmt, ...) (void)0
245 #define AUDIO_STRINGIFY_(n) #n
246 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
248 typedef struct AudiodevListEntry
{
250 QSIMPLEQ_ENTRY(AudiodevListEntry
) next
;
253 typedef QSIMPLEQ_HEAD(, AudiodevListEntry
) AudiodevListHead
;
254 AudiodevListHead
audio_handle_legacy_opts(void);
256 void audio_free_audiodev_list(AudiodevListHead
*head
);
258 void audio_create_pdos(Audiodev
*dev
);
259 AudiodevPerDirectionOptions
*audio_get_pdo_in(Audiodev
*dev
);
260 AudiodevPerDirectionOptions
*audio_get_pdo_out(Audiodev
*dev
);
262 #endif /* QEMU_AUDIO_INT_H */