2 * QEMU DirectSound audio driver
4 * Copyright (c) 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
26 * SEAL 1.07 by Carlos 'pel' Hasan was used as documentation
29 #include "qemu/osdep.h"
32 #define AUDIO_CAP "dsound"
33 #include "audio_int.h"
34 #include "qemu/host-utils.h"
35 #include "qemu/module.h"
42 #include "audio_win_int.h"
44 /* #define DEBUG_DSOUND */
48 LPDIRECTSOUNDCAPTURE dsound_capture
;
49 struct audsettings settings
;
55 LPDIRECTSOUNDBUFFER dsound_buffer
;
62 LPDIRECTSOUNDCAPTUREBUFFER dsound_capture_buffer
;
67 static void dsound_log_hresult (HRESULT hr
)
69 const char *str
= "BUG";
73 str
= "The method succeeded";
75 #ifdef DS_NO_VIRTUALIZATION
76 case DS_NO_VIRTUALIZATION
:
77 str
= "The buffer was created, but another 3D algorithm was substituted";
82 str
= "The method succeeded, but not all the optional effects were obtained";
85 #ifdef DSERR_ACCESSDENIED
86 case DSERR_ACCESSDENIED
:
87 str
= "The request failed because access was denied";
90 #ifdef DSERR_ALLOCATED
92 str
= "The request failed because resources, "
93 "such as a priority level, were already in use "
97 #ifdef DSERR_ALREADYINITIALIZED
98 case DSERR_ALREADYINITIALIZED
:
99 str
= "The object is already initialized";
102 #ifdef DSERR_BADFORMAT
103 case DSERR_BADFORMAT
:
104 str
= "The specified wave format is not supported";
107 #ifdef DSERR_BADSENDBUFFERGUID
108 case DSERR_BADSENDBUFFERGUID
:
109 str
= "The GUID specified in an audiopath file "
110 "does not match a valid mix-in buffer";
113 #ifdef DSERR_BUFFERLOST
114 case DSERR_BUFFERLOST
:
115 str
= "The buffer memory has been lost and must be restored";
118 #ifdef DSERR_BUFFERTOOSMALL
119 case DSERR_BUFFERTOOSMALL
:
120 str
= "The buffer size is not great enough to "
121 "enable effects processing";
124 #ifdef DSERR_CONTROLUNAVAIL
125 case DSERR_CONTROLUNAVAIL
:
126 str
= "The buffer control (volume, pan, and so on) "
127 "requested by the caller is not available. "
128 "Controls must be specified when the buffer is created, "
129 "using the dwFlags member of DSBUFFERDESC";
132 #ifdef DSERR_DS8_REQUIRED
133 case DSERR_DS8_REQUIRED
:
134 str
= "A DirectSound object of class CLSID_DirectSound8 or later "
135 "is required for the requested functionality. "
136 "For more information, see IDirectSound8 Interface";
139 #ifdef DSERR_FXUNAVAILABLE
140 case DSERR_FXUNAVAILABLE
:
141 str
= "The effects requested could not be found on the system, "
142 "or they are in the wrong order or in the wrong location; "
143 "for example, an effect expected in hardware "
144 "was found in software";
149 str
= "An undetermined error occurred inside the DirectSound subsystem";
152 #ifdef DSERR_INVALIDCALL
153 case DSERR_INVALIDCALL
:
154 str
= "This function is not valid for the current state of this object";
157 #ifdef DSERR_INVALIDPARAM
158 case DSERR_INVALIDPARAM
:
159 str
= "An invalid parameter was passed to the returning function";
162 #ifdef DSERR_NOAGGREGATION
163 case DSERR_NOAGGREGATION
:
164 str
= "The object does not support aggregation";
167 #ifdef DSERR_NODRIVER
169 str
= "No sound driver is available for use, "
170 "or the given GUID is not a valid DirectSound device ID";
173 #ifdef DSERR_NOINTERFACE
174 case DSERR_NOINTERFACE
:
175 str
= "The requested COM interface is not available";
178 #ifdef DSERR_OBJECTNOTFOUND
179 case DSERR_OBJECTNOTFOUND
:
180 str
= "The requested object was not found";
183 #ifdef DSERR_OTHERAPPHASPRIO
184 case DSERR_OTHERAPPHASPRIO
:
185 str
= "Another application has a higher priority level, "
186 "preventing this call from succeeding";
189 #ifdef DSERR_OUTOFMEMORY
190 case DSERR_OUTOFMEMORY
:
191 str
= "The DirectSound subsystem could not allocate "
192 "sufficient memory to complete the caller's request";
195 #ifdef DSERR_PRIOLEVELNEEDED
196 case DSERR_PRIOLEVELNEEDED
:
197 str
= "A cooperative level of DSSCL_PRIORITY or higher is required";
200 #ifdef DSERR_SENDLOOP
202 str
= "A circular loop of send effects was detected";
205 #ifdef DSERR_UNINITIALIZED
206 case DSERR_UNINITIALIZED
:
207 str
= "The Initialize method has not been called "
208 "or has not been called successfully "
209 "before other methods were called";
212 #ifdef DSERR_UNSUPPORTED
213 case DSERR_UNSUPPORTED
:
214 str
= "The function called is not supported at this time";
218 AUD_log (AUDIO_CAP
, "Reason: Unknown (HRESULT 0x%lx)\n", hr
);
222 AUD_log (AUDIO_CAP
, "Reason: %s\n", str
);
225 static void GCC_FMT_ATTR (2, 3) dsound_logerr (
234 AUD_vlog (AUDIO_CAP
, fmt
, ap
);
237 dsound_log_hresult (hr
);
240 static void GCC_FMT_ATTR (3, 4) dsound_logerr2 (
249 AUD_log (AUDIO_CAP
, "Could not initialize %s\n", typ
);
251 AUD_vlog (AUDIO_CAP
, fmt
, ap
);
254 dsound_log_hresult (hr
);
258 static void print_wave_format (WAVEFORMATEX
*wfx
)
260 dolog ("tag = %d\n", wfx
->wFormatTag
);
261 dolog ("nChannels = %d\n", wfx
->nChannels
);
262 dolog ("nSamplesPerSec = %ld\n", wfx
->nSamplesPerSec
);
263 dolog ("nAvgBytesPerSec = %ld\n", wfx
->nAvgBytesPerSec
);
264 dolog ("nBlockAlign = %d\n", wfx
->nBlockAlign
);
265 dolog ("wBitsPerSample = %d\n", wfx
->wBitsPerSample
);
266 dolog ("cbSize = %d\n", wfx
->cbSize
);
270 static int dsound_restore_out (LPDIRECTSOUNDBUFFER dsb
, dsound
*s
)
274 hr
= IDirectSoundBuffer_Restore (dsb
);
277 dsound_logerr (hr
, "Could not restore playback buffer\n");
283 #include "dsound_template.h"
285 #include "dsound_template.h"
288 static int dsound_get_status_out (LPDIRECTSOUNDBUFFER dsb
, DWORD
*statusp
,
293 hr
= IDirectSoundBuffer_GetStatus (dsb
, statusp
);
295 dsound_logerr (hr
, "Could not get playback buffer status\n");
299 if (*statusp
& DSBSTATUS_BUFFERLOST
) {
300 dsound_restore_out(dsb
, s
);
307 static int dsound_get_status_in (LPDIRECTSOUNDCAPTUREBUFFER dscb
,
312 hr
= IDirectSoundCaptureBuffer_GetStatus (dscb
, statusp
);
314 dsound_logerr (hr
, "Could not get capture buffer status\n");
321 static void dsound_clear_sample (HWVoiceOut
*hw
, LPDIRECTSOUNDBUFFER dsb
,
326 DWORD blen1
, blen2
, len1
, len2
;
328 err
= dsound_lock_out (
342 len1
= blen1
/ hw
->info
.bytes_per_frame
;
343 len2
= blen2
/ hw
->info
.bytes_per_frame
;
346 dolog ("clear %p,%ld,%ld %p,%ld,%ld\n",
352 audio_pcm_info_clear_buf (&hw
->info
, p1
, len1
);
356 audio_pcm_info_clear_buf (&hw
->info
, p2
, len2
);
359 dsound_unlock_out (dsb
, p1
, p2
, blen1
, blen2
);
362 static int dsound_set_cooperative_level(dsound
*s
)
367 hwnd
= GetDesktopWindow();
368 hr
= IDirectSound_SetCooperativeLevel (
375 dsound_logerr (hr
, "Could not set cooperative level for window %p\n",
383 static void dsound_enable_out(HWVoiceOut
*hw
, bool enable
)
387 DSoundVoiceOut
*ds
= (DSoundVoiceOut
*) hw
;
388 LPDIRECTSOUNDBUFFER dsb
= ds
->dsound_buffer
;
392 dolog ("Attempt to control voice without a buffer\n");
397 if (dsound_get_status_out (dsb
, &status
, s
)) {
401 if (status
& DSBSTATUS_PLAYING
) {
402 dolog ("warning: Voice is already playing\n");
406 dsound_clear_sample (hw
, dsb
, s
);
408 hr
= IDirectSoundBuffer_Play (dsb
, 0, 0, DSBPLAY_LOOPING
);
410 dsound_logerr (hr
, "Could not start playing buffer\n");
414 if (dsound_get_status_out (dsb
, &status
, s
)) {
418 if (status
& DSBSTATUS_PLAYING
) {
419 hr
= IDirectSoundBuffer_Stop (dsb
);
421 dsound_logerr (hr
, "Could not stop playing buffer\n");
425 dolog ("warning: Voice is not playing\n");
430 static void *dsound_get_buffer_out(HWVoiceOut
*hw
, size_t *size
)
432 DSoundVoiceOut
*ds
= (DSoundVoiceOut
*) hw
;
433 LPDIRECTSOUNDBUFFER dsb
= ds
->dsound_buffer
;
435 DWORD ppos
, wpos
, act_size
;
440 hr
= IDirectSoundBuffer_GetCurrentPosition(
441 dsb
, &ppos
, ds
->first_time
? &wpos
: NULL
);
443 dsound_logerr(hr
, "Could not get playback buffer position\n");
448 if (ds
->first_time
) {
450 ds
->first_time
= false;
453 req_size
= audio_ring_dist(ppos
, hw
->pos_emul
, hw
->size_emul
);
454 req_size
= MIN(req_size
, hw
->size_emul
- hw
->pos_emul
);
461 err
= dsound_lock_out(dsb
, &hw
->info
, hw
->pos_emul
, req_size
, &ret
, NULL
,
462 &act_size
, NULL
, false, ds
->s
);
464 dolog("Failed to lock buffer\n");
473 static size_t dsound_put_buffer_out(HWVoiceOut
*hw
, void *buf
, size_t len
)
475 DSoundVoiceOut
*ds
= (DSoundVoiceOut
*) hw
;
476 LPDIRECTSOUNDBUFFER dsb
= ds
->dsound_buffer
;
477 int err
= dsound_unlock_out(dsb
, buf
, NULL
, len
, 0);
480 dolog("Failed to unlock buffer!!\n");
483 hw
->pos_emul
= (hw
->pos_emul
+ len
) % hw
->size_emul
;
488 static void dsound_enable_in(HWVoiceIn
*hw
, bool enable
)
492 DSoundVoiceIn
*ds
= (DSoundVoiceIn
*) hw
;
493 LPDIRECTSOUNDCAPTUREBUFFER dscb
= ds
->dsound_capture_buffer
;
496 dolog ("Attempt to control capture voice without a buffer\n");
501 if (dsound_get_status_in (dscb
, &status
)) {
505 if (status
& DSCBSTATUS_CAPTURING
) {
506 dolog ("warning: Voice is already capturing\n");
512 hr
= IDirectSoundCaptureBuffer_Start (dscb
, DSCBSTART_LOOPING
);
514 dsound_logerr (hr
, "Could not start capturing\n");
518 if (dsound_get_status_in (dscb
, &status
)) {
522 if (status
& DSCBSTATUS_CAPTURING
) {
523 hr
= IDirectSoundCaptureBuffer_Stop (dscb
);
525 dsound_logerr (hr
, "Could not stop capturing\n");
529 dolog ("warning: Voice is not capturing\n");
534 static void *dsound_get_buffer_in(HWVoiceIn
*hw
, size_t *size
)
536 DSoundVoiceIn
*ds
= (DSoundVoiceIn
*) hw
;
537 LPDIRECTSOUNDCAPTUREBUFFER dscb
= ds
->dsound_capture_buffer
;
539 DWORD rpos
, act_size
;
544 hr
= IDirectSoundCaptureBuffer_GetCurrentPosition(dscb
, NULL
, &rpos
);
546 dsound_logerr(hr
, "Could not get capture buffer position\n");
551 if (ds
->first_time
) {
553 ds
->first_time
= false;
556 req_size
= audio_ring_dist(rpos
, hw
->pos_emul
, hw
->size_emul
);
557 req_size
= MIN(*size
, MIN(req_size
, hw
->size_emul
- hw
->pos_emul
));
564 err
= dsound_lock_in(dscb
, &hw
->info
, hw
->pos_emul
, req_size
, &ret
, NULL
,
565 &act_size
, NULL
, false, ds
->s
);
567 dolog("Failed to lock buffer\n");
576 static void dsound_put_buffer_in(HWVoiceIn
*hw
, void *buf
, size_t len
)
578 DSoundVoiceIn
*ds
= (DSoundVoiceIn
*) hw
;
579 LPDIRECTSOUNDCAPTUREBUFFER dscb
= ds
->dsound_capture_buffer
;
580 int err
= dsound_unlock_in(dscb
, buf
, NULL
, len
, 0);
583 dolog("Failed to unlock buffer!!\n");
586 hw
->pos_emul
= (hw
->pos_emul
+ len
) % hw
->size_emul
;
589 static void dsound_audio_fini (void *opaque
)
599 hr
= IDirectSound_Release (s
->dsound
);
601 dsound_logerr (hr
, "Could not release DirectSound\n");
605 if (!s
->dsound_capture
) {
610 hr
= IDirectSoundCapture_Release (s
->dsound_capture
);
612 dsound_logerr (hr
, "Could not release DirectSoundCapture\n");
614 s
->dsound_capture
= NULL
;
619 static void *dsound_audio_init(Audiodev
*dev
)
623 dsound
*s
= g_malloc0(sizeof(dsound
));
624 AudiodevDsoundOptions
*dso
;
626 assert(dev
->driver
== AUDIODEV_DRIVER_DSOUND
);
628 dso
= &dev
->u
.dsound
;
630 if (!dso
->has_latency
) {
631 dso
->has_latency
= true;
632 dso
->latency
= 10000; /* 10 ms */
635 hr
= CoInitialize (NULL
);
637 dsound_logerr (hr
, "Could not initialize COM\n");
642 hr
= CoCreateInstance (
650 dsound_logerr (hr
, "Could not create DirectSound instance\n");
655 hr
= IDirectSound_Initialize (s
->dsound
, NULL
);
657 dsound_logerr (hr
, "Could not initialize DirectSound\n");
659 hr
= IDirectSound_Release (s
->dsound
);
661 dsound_logerr (hr
, "Could not release DirectSound\n");
667 hr
= CoCreateInstance (
668 &CLSID_DirectSoundCapture
,
671 &IID_IDirectSoundCapture
,
672 (void **) &s
->dsound_capture
675 dsound_logerr (hr
, "Could not create DirectSoundCapture instance\n");
677 hr
= IDirectSoundCapture_Initialize (s
->dsound_capture
, NULL
);
679 dsound_logerr (hr
, "Could not initialize DirectSoundCapture\n");
681 hr
= IDirectSoundCapture_Release (s
->dsound_capture
);
683 dsound_logerr (hr
, "Could not release DirectSoundCapture\n");
685 s
->dsound_capture
= NULL
;
689 err
= dsound_set_cooperative_level(s
);
691 dsound_audio_fini (s
);
698 static struct audio_pcm_ops dsound_pcm_ops
= {
699 .init_out
= dsound_init_out
,
700 .fini_out
= dsound_fini_out
,
701 .write
= audio_generic_write
,
702 .get_buffer_out
= dsound_get_buffer_out
,
703 .put_buffer_out
= dsound_put_buffer_out
,
704 .enable_out
= dsound_enable_out
,
706 .init_in
= dsound_init_in
,
707 .fini_in
= dsound_fini_in
,
708 .read
= audio_generic_read
,
709 .get_buffer_in
= dsound_get_buffer_in
,
710 .put_buffer_in
= dsound_put_buffer_in
,
711 .enable_in
= dsound_enable_in
,
714 static struct audio_driver dsound_audio_driver
= {
716 .descr
= "DirectSound http://wikipedia.org/wiki/DirectSound",
717 .init
= dsound_audio_init
,
718 .fini
= dsound_audio_fini
,
719 .pcm_ops
= &dsound_pcm_ops
,
721 .max_voices_out
= INT_MAX
,
723 .voice_size_out
= sizeof (DSoundVoiceOut
),
724 .voice_size_in
= sizeof (DSoundVoiceIn
)
727 static void register_audio_dsound(void)
729 audio_driver_register(&dsound_audio_driver
);
731 type_init(register_audio_dsound
);