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
;
69 size_t pos_emul
, pending_emul
, size_emul
;
72 QLIST_HEAD (sw_out_listhead
, SWVoiceOut
) sw_head
;
73 QLIST_HEAD (sw_cap_listhead
, SWVoiceCap
) cap_head
;
75 struct audio_pcm_ops
*pcm_ops
;
76 QLIST_ENTRY (HWVoiceOut
) entries
;
79 typedef struct HWVoiceIn
{
83 struct audio_pcm_info info
;
88 size_t total_samples_captured
;
91 struct st_sample
*conv_buf
;
93 size_t pos_emul
, pending_emul
, size_emul
;
96 QLIST_HEAD (sw_in_listhead
, SWVoiceIn
) sw_head
;
98 struct audio_pcm_ops
*pcm_ops
;
99 QLIST_ENTRY (HWVoiceIn
) entries
;
105 struct audio_pcm_info info
;
108 struct st_sample
*buf
;
110 size_t total_hw_samples_mixed
;
115 struct mixeng_volume vol
;
116 struct audio_callback callback
;
117 QLIST_ENTRY (SWVoiceOut
) entries
;
124 struct audio_pcm_info info
;
127 size_t total_hw_samples_acquired
;
128 struct st_sample
*buf
;
132 struct mixeng_volume vol
;
133 struct audio_callback callback
;
134 QLIST_ENTRY (SWVoiceIn
) entries
;
137 typedef struct audio_driver audio_driver
;
138 struct audio_driver
{
141 void *(*init
) (Audiodev
*);
142 void (*fini
) (void *);
143 struct audio_pcm_ops
*pcm_ops
;
150 QLIST_ENTRY(audio_driver
) next
;
153 struct audio_pcm_ops
{
154 int (*init_out
)(HWVoiceOut
*hw
, audsettings
*as
, void *drv_opaque
);
155 void (*fini_out
)(HWVoiceOut
*hw
);
156 size_t (*run_out
)(HWVoiceOut
*hw
, size_t live
);
157 size_t (*write
) (HWVoiceOut
*hw
, void *buf
, size_t size
);
159 * get a buffer that after later can be passed to put_buffer_out; optional
160 * returns the buffer, and writes it's size to size (in bytes)
161 * this is unrelated to the above buffer_size_out function
163 void *(*get_buffer_out
)(HWVoiceOut
*hw
, size_t *size
);
165 * put back the buffer returned by get_buffer_out; optional
166 * buf must be equal the pointer returned by get_buffer_out,
167 * size may be smaller
169 size_t (*put_buffer_out
)(HWVoiceOut
*hw
, void *buf
, size_t size
);
170 int (*ctl_out
) (HWVoiceOut
*hw
, int cmd
, ...);
172 int (*init_in
) (HWVoiceIn
*hw
, audsettings
*as
, void *drv_opaque
);
173 void (*fini_in
) (HWVoiceIn
*hw
);
174 size_t (*run_in
)(HWVoiceIn
*hw
);
175 size_t (*read
) (HWVoiceIn
*hw
, void *buf
, size_t size
);
176 void *(*get_buffer_in
)(HWVoiceIn
*hw
, size_t *size
);
177 void (*put_buffer_in
)(HWVoiceIn
*hw
, void *buf
, size_t size
);
178 int (*ctl_in
) (HWVoiceIn
*hw
, int cmd
, ...);
181 void *audio_generic_get_buffer_in(HWVoiceIn
*hw
, size_t *size
);
182 void audio_generic_put_buffer_in(HWVoiceIn
*hw
, void *buf
, size_t size
);
183 void *audio_generic_get_buffer_out(HWVoiceOut
*hw
, size_t *size
);
184 size_t audio_generic_put_buffer_out(HWVoiceOut
*hw
, void *buf
, size_t size
);
185 size_t audio_generic_put_buffer_out_nowrite(HWVoiceOut
*hw
, void *buf
,
187 size_t audio_generic_write(HWVoiceOut
*hw
, void *buf
, size_t size
);
188 size_t audio_generic_read(HWVoiceIn
*hw
, void *buf
, size_t size
);
190 struct capture_callback
{
191 struct audio_capture_ops ops
;
193 QLIST_ENTRY (capture_callback
) entries
;
196 struct CaptureVoiceOut
{
199 QLIST_HEAD (cb_listhead
, capture_callback
) cb_head
;
200 QLIST_ENTRY (CaptureVoiceOut
) entries
;
205 CaptureVoiceOut
*cap
;
206 QLIST_ENTRY (SWVoiceCap
) entries
;
209 typedef struct AudioState
{
210 struct audio_driver
*drv
;
215 QLIST_HEAD (card_listhead
, QEMUSoundCard
) card_head
;
216 QLIST_HEAD (hw_in_listhead
, HWVoiceIn
) hw_head_in
;
217 QLIST_HEAD (hw_out_listhead
, HWVoiceOut
) hw_head_out
;
218 QLIST_HEAD (cap_listhead
, CaptureVoiceOut
) cap_head
;
219 int nb_hw_voices_out
;
222 int64_t period_ticks
;
227 QTAILQ_ENTRY(AudioState
) list
;
230 extern const struct mixeng_volume nominal_volume
;
232 extern const char *audio_prio_list
[];
234 void audio_driver_register(audio_driver
*drv
);
235 audio_driver
*audio_driver_lookup(const char *name
);
237 void audio_pcm_init_info (struct audio_pcm_info
*info
, struct audsettings
*as
);
238 void audio_pcm_info_clear_buf (struct audio_pcm_info
*info
, void *buf
, int len
);
240 size_t audio_pcm_hw_get_live_in(HWVoiceIn
*hw
);
242 size_t audio_pcm_hw_clip_out(HWVoiceOut
*hw
, void *pcm_buf
,
243 size_t live
, size_t pending
);
245 int audio_bug (const char *funcname
, int cond
);
246 void *audio_calloc (const char *funcname
, int nmemb
, size_t size
);
248 void audio_run(AudioState
*s
, const char *msg
);
250 #define VOICE_ENABLE 1
251 #define VOICE_DISABLE 2
252 #define VOICE_VOLUME 3
254 #define VOICE_VOLUME_CAP (1 << VOICE_VOLUME)
256 static inline size_t audio_ring_dist(size_t dst
, size_t src
, size_t len
)
258 return (dst
>= src
) ? (dst
- src
) : (len
- src
+ dst
);
261 #define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
264 #define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
266 #define ldebug(fmt, ...) (void)0
269 #define AUDIO_STRINGIFY_(n) #n
270 #define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
272 typedef struct AudiodevListEntry
{
274 QSIMPLEQ_ENTRY(AudiodevListEntry
) next
;
277 typedef QSIMPLEQ_HEAD(, AudiodevListEntry
) AudiodevListHead
;
278 AudiodevListHead
audio_handle_legacy_opts(void);
280 void audio_free_audiodev_list(AudiodevListHead
*head
);
282 void audio_create_pdos(Audiodev
*dev
);
283 AudiodevPerDirectionOptions
*audio_get_pdo_in(Audiodev
*dev
);
284 AudiodevPerDirectionOptions
*audio_get_pdo_out(Audiodev
*dev
);
286 #endif /* QEMU_AUDIO_INT_H */