3 * Copyright 1998 Marcus Meissner
4 * Copyright 1998 Rob Riggs
5 * Copyright 2000-2001 TransGaming Technologies, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 /* Linux does not support better timing than 10ms */
23 #define DS_TIME_RES 2 /* Resolution of multimedia timer */
24 #define DS_TIME_DEL 10 /* Delay of multimedia timer callback, and duration of HEL fragment */
26 #include "wine/list.h"
28 /* direct sound hardware acceleration levels */
29 #define DS_HW_ACCEL_FULL 0 /* default on Windows 98 */
30 #define DS_HW_ACCEL_STANDARD 1 /* default on Windows 2000 */
31 #define DS_HW_ACCEL_BASIC 2
32 #define DS_HW_ACCEL_EMULATION 3
34 extern int ds_emuldriver
;
35 extern int ds_hel_buflen
;
36 extern int ds_snd_queue_max
;
37 extern int ds_snd_queue_min
;
38 extern int ds_snd_shadow_maxsize
;
39 extern int ds_hw_accel
;
40 extern int ds_default_playback
;
41 extern int ds_default_capture
;
42 extern int ds_default_sample_rate
;
43 extern int ds_default_bits_per_sample
;
45 /*****************************************************************************
46 * Predeclare the interface implementation structures
48 typedef struct IDirectSoundImpl IDirectSoundImpl
;
49 typedef struct IDirectSound_IUnknown IDirectSound_IUnknown
;
50 typedef struct IDirectSound_IDirectSound IDirectSound_IDirectSound
;
51 typedef struct IDirectSound8_IUnknown IDirectSound8_IUnknown
;
52 typedef struct IDirectSound8_IDirectSound IDirectSound8_IDirectSound
;
53 typedef struct IDirectSound8_IDirectSound8 IDirectSound8_IDirectSound8
;
54 typedef struct IDirectSoundBufferImpl IDirectSoundBufferImpl
;
55 typedef struct IDirectSoundCaptureImpl IDirectSoundCaptureImpl
;
56 typedef struct IDirectSoundCaptureBufferImpl IDirectSoundCaptureBufferImpl
;
57 typedef struct IDirectSoundFullDuplexImpl IDirectSoundFullDuplexImpl
;
58 typedef struct IDirectSoundFullDuplex_IUnknown IDirectSoundFullDuplex_IUnknown
;
59 typedef struct IDirectSoundFullDuplex_IDirectSound IDirectSoundFullDuplex_IDirectSound
;
60 typedef struct IDirectSoundFullDuplex_IDirectSound8 IDirectSoundFullDuplex_IDirectSound8
;
61 typedef struct IDirectSoundFullDuplex_IDirectSoundCapture IDirectSoundFullDuplex_IDirectSoundCapture
;
62 typedef struct IDirectSoundNotifyImpl IDirectSoundNotifyImpl
;
63 typedef struct IDirectSoundCaptureNotifyImpl IDirectSoundCaptureNotifyImpl
;
64 typedef struct IDirectSound3DListenerImpl IDirectSound3DListenerImpl
;
65 typedef struct IDirectSound3DBufferImpl IDirectSound3DBufferImpl
;
66 typedef struct IKsBufferPropertySetImpl IKsBufferPropertySetImpl
;
67 typedef struct IKsPrivatePropertySetImpl IKsPrivatePropertySetImpl
;
68 typedef struct PrimaryBufferImpl PrimaryBufferImpl
;
69 typedef struct SecondaryBufferImpl SecondaryBufferImpl
;
70 typedef struct DirectSoundDevice DirectSoundDevice
;
71 typedef struct DirectSoundCaptureDevice DirectSoundCaptureDevice
;
73 /* dsound_convert.h */
74 typedef void (*bitsconvertfunc
)(const void *, void *);
75 extern const bitsconvertfunc convertbpp
[4][4];
76 typedef void (*mixfunc
)(const void *, void *, unsigned);
77 extern const mixfunc mixfunctions
[4];
78 typedef void (*normfunc
)(const void *, void *, unsigned);
79 extern const normfunc normfunctions
[4];
81 /*****************************************************************************
82 * IDirectSoundDevice implementation structure
84 struct DirectSoundDevice
96 UINT timerID
, pwplay
, pwqueue
, prebuf
, helfrags
;
98 PIDSDRIVERBUFFER hwbuf
;
100 DWORD writelead
, buflen
, state
, playpos
, mixpos
;
102 IDirectSoundBufferImpl
** buffers
;
103 RTL_RWLOCK buffer_list_lock
;
104 CRITICAL_SECTION mixlock
;
105 PrimaryBufferImpl
* primary
;
107 DWORD speaker_config
;
108 LPBYTE tmp_buffer
, mix_buffer
;
109 DWORD tmp_buffer_len
, mix_buffer_len
;
114 normfunc normfunction
;
116 /* DirectSound3DListener fields */
117 IDirectSound3DListenerImpl
* listener
;
119 BOOL ds3dl_need_recalc
;
122 /* reference counted buffer memory for duplicated buffer memory */
123 typedef struct BufferMemory
130 ULONG
DirectSoundDevice_Release(DirectSoundDevice
* device
);
131 HRESULT
DirectSoundDevice_Initialize(
132 DirectSoundDevice
** ppDevice
,
134 HRESULT
DirectSoundDevice_AddBuffer(
135 DirectSoundDevice
* device
,
136 IDirectSoundBufferImpl
* pDSB
);
137 HRESULT
DirectSoundDevice_RemoveBuffer(
138 DirectSoundDevice
* device
,
139 IDirectSoundBufferImpl
* pDSB
);
140 HRESULT
DirectSoundDevice_GetCaps(DirectSoundDevice
* device
, LPDSCAPS lpDSCaps
);
141 HRESULT
DirectSoundDevice_CreateSoundBuffer(
142 DirectSoundDevice
* device
,
143 LPCDSBUFFERDESC dsbd
,
144 LPLPDIRECTSOUNDBUFFER ppdsb
,
147 HRESULT
DirectSoundDevice_DuplicateSoundBuffer(
148 DirectSoundDevice
* device
,
149 LPDIRECTSOUNDBUFFER psb
,
150 LPLPDIRECTSOUNDBUFFER ppdsb
);
151 HRESULT
DirectSoundDevice_SetCooperativeLevel(
152 DirectSoundDevice
* devcie
,
155 HRESULT
DirectSoundDevice_Compact(DirectSoundDevice
* device
);
156 HRESULT
DirectSoundDevice_GetSpeakerConfig(
157 DirectSoundDevice
* device
,
158 LPDWORD lpdwSpeakerConfig
);
159 HRESULT
DirectSoundDevice_SetSpeakerConfig(
160 DirectSoundDevice
* device
,
163 /*****************************************************************************
164 * IDirectSoundBuffer implementation structure
166 struct IDirectSoundBufferImpl
168 /* FIXME: document */
169 /* IUnknown fields */
170 const IDirectSoundBuffer8Vtbl
*lpVtbl
;
172 /* IDirectSoundBufferImpl fields */
173 SecondaryBufferImpl
* secondary
;
174 DirectSoundDevice
* device
;
176 PIDSDRIVERBUFFER hwbuf
;
178 BufferMemory
* buffer
;
180 DWORD playflags
,state
,leadin
;
181 DWORD writelead
,buflen
;
182 DWORD nAvgBytesPerSec
;
183 DWORD freq
, tmp_buffer_len
, max_buffer_len
;
186 /* used for frequency conversion (PerfectPitch) */
187 ULONG freqneeded
, freqAdjust
, freqAcc
, freqAccNext
, resampleinmixer
;
188 /* used for mixing */
189 DWORD primary_mixpos
, buf_mixpos
, sec_mixpos
;
191 /* IDirectSoundNotifyImpl fields */
192 IDirectSoundNotifyImpl
* notify
;
193 LPDSBPOSITIONNOTIFY notifies
;
195 PIDSDRIVERNOTIFY hwnotify
;
197 /* DirectSound3DBuffer fields */
198 IDirectSound3DBufferImpl
* ds3db
;
199 DS3DBUFFER ds3db_ds3db
;
201 BOOL ds3db_need_recalc
;
203 /* IKsPropertySet fields */
204 IKsBufferPropertySetImpl
* iks
;
205 bitsconvertfunc convert
;
209 HRESULT
IDirectSoundBufferImpl_Create(
210 DirectSoundDevice
*device
,
211 IDirectSoundBufferImpl
**ppdsb
,
212 LPCDSBUFFERDESC dsbd
);
213 HRESULT
IDirectSoundBufferImpl_Destroy(
214 IDirectSoundBufferImpl
*pdsb
);
215 HRESULT
IDirectSoundBufferImpl_Duplicate(
216 DirectSoundDevice
*device
,
217 IDirectSoundBufferImpl
**ppdsb
,
218 IDirectSoundBufferImpl
*pdsb
);
220 /*****************************************************************************
221 * SecondaryBuffer implementation structure
223 struct SecondaryBufferImpl
225 const IDirectSoundBuffer8Vtbl
*lpVtbl
;
227 IDirectSoundBufferImpl
* dsb
;
230 HRESULT
SecondaryBufferImpl_Create(
231 IDirectSoundBufferImpl
*dsb
,
232 SecondaryBufferImpl
**pdsb
);
234 /*****************************************************************************
235 * PrimaryBuffer implementation structure
237 struct PrimaryBufferImpl
239 const IDirectSoundBufferVtbl
*lpVtbl
;
241 DirectSoundDevice
* device
;
244 HRESULT
PrimaryBufferImpl_Create(
245 DirectSoundDevice
* device
,
246 PrimaryBufferImpl
**ppdsb
,
247 LPCDSBUFFERDESC dsbd
);
249 /*****************************************************************************
250 * DirectSoundCaptureDevice implementation structure
252 struct DirectSoundCaptureDevice
254 /* IDirectSoundCaptureImpl fields */
258 /* DirectSound driver stuff */
260 DSDRIVERDESC drvdesc
;
261 DSCDRIVERCAPS drvcaps
;
262 PIDSCDRIVERBUFFER hwbuf
;
264 /* wave driver info */
273 IDirectSoundCaptureBufferImpl
* capture_buffer
;
278 CRITICAL_SECTION lock
;
281 HRESULT
DirectSoundCaptureDevice_Initialize(
282 DirectSoundCaptureDevice
** ppDevice
,
284 ULONG
DirectSoundCaptureDevice_Release(
285 DirectSoundCaptureDevice
* device
);
287 /*****************************************************************************
288 * IDirectSoundCaptureBuffer implementation structure
290 struct IDirectSoundCaptureBufferImpl
292 /* IUnknown fields */
293 const IDirectSoundCaptureBuffer8Vtbl
*lpVtbl
;
296 /* IDirectSoundCaptureBufferImpl fields */
297 DirectSoundCaptureDevice
* device
;
298 /* FIXME: don't need this */
299 LPDSCBUFFERDESC pdscbd
;
302 /* IDirectSoundCaptureNotifyImpl fields */
303 IDirectSoundCaptureNotifyImpl
* notify
;
304 LPDSBPOSITIONNOTIFY notifies
;
306 PIDSDRIVERNOTIFY hwnotify
;
309 HRESULT
IDirectSoundCaptureBufferImpl_Create(
310 DirectSoundCaptureDevice
*device
,
311 IDirectSoundCaptureBufferImpl
** ppobj
,
312 LPCDSCBUFFERDESC lpcDSCBufferDesc
);
314 /*****************************************************************************
315 * IDirectSoundFullDuplex implementation structure
317 struct IDirectSoundFullDuplexImpl
319 /* IUnknown fields */
320 const IDirectSoundFullDuplexVtbl
*lpVtbl
;
323 /* IDirectSoundFullDuplexImpl fields */
324 DirectSoundDevice
*renderer_device
;
325 DirectSoundCaptureDevice
*capture_device
;
330 LPDIRECTSOUNDCAPTURE pDSC
;
333 /*****************************************************************************
334 * IDirectSoundFullDuplex COM components
336 struct IDirectSoundFullDuplex_IUnknown
{
337 const IUnknownVtbl
*lpVtbl
;
339 IDirectSoundFullDuplexImpl
*pdsfd
;
342 struct IDirectSoundFullDuplex_IDirectSound
{
343 const IDirectSoundVtbl
*lpVtbl
;
345 IDirectSoundFullDuplexImpl
*pdsfd
;
348 struct IDirectSoundFullDuplex_IDirectSound8
{
349 const IDirectSound8Vtbl
*lpVtbl
;
351 IDirectSoundFullDuplexImpl
*pdsfd
;
354 struct IDirectSoundFullDuplex_IDirectSoundCapture
{
355 const IDirectSoundCaptureVtbl
*lpVtbl
;
357 IDirectSoundFullDuplexImpl
*pdsfd
;
360 /*****************************************************************************
361 * IDirectSound3DListener implementation structure
363 struct IDirectSound3DListenerImpl
365 /* IUnknown fields */
366 const IDirectSound3DListenerVtbl
*lpVtbl
;
368 /* IDirectSound3DListenerImpl fields */
369 DirectSoundDevice
* device
;
372 HRESULT
IDirectSound3DListenerImpl_Create(
373 DirectSoundDevice
*device
,
374 IDirectSound3DListenerImpl
**pdsl
);
376 /*****************************************************************************
377 * IKsBufferPropertySet implementation structure
379 struct IKsBufferPropertySetImpl
381 /* IUnknown fields */
382 const IKsPropertySetVtbl
*lpVtbl
;
384 /* IKsPropertySetImpl fields */
385 IDirectSoundBufferImpl
* dsb
;
388 HRESULT
IKsBufferPropertySetImpl_Create(
389 IDirectSoundBufferImpl
*dsb
,
390 IKsBufferPropertySetImpl
**piks
);
391 HRESULT
IKsBufferPropertySetImpl_Destroy(
392 IKsBufferPropertySetImpl
*piks
);
394 /*****************************************************************************
395 * IKsPrivatePropertySet implementation structure
397 struct IKsPrivatePropertySetImpl
399 /* IUnknown fields */
400 const IKsPropertySetVtbl
*lpVtbl
;
404 HRESULT
IKsPrivatePropertySetImpl_Create(
406 IKsPrivatePropertySetImpl
**piks
);
408 /*****************************************************************************
409 * IDirectSound3DBuffer implementation structure
411 struct IDirectSound3DBufferImpl
413 /* IUnknown fields */
414 const IDirectSound3DBufferVtbl
*lpVtbl
;
416 /* IDirectSound3DBufferImpl fields */
417 IDirectSoundBufferImpl
* dsb
;
420 HRESULT
IDirectSound3DBufferImpl_Create(
421 IDirectSoundBufferImpl
*dsb
,
422 IDirectSound3DBufferImpl
**pds3db
);
423 HRESULT
IDirectSound3DBufferImpl_Destroy(
424 IDirectSound3DBufferImpl
*pds3db
);
426 /*******************************************************************************
431 HRESULT
DSOUND_Create(REFIID riid
, LPDIRECTSOUND
*ppDS
);
432 HRESULT
DSOUND_Create8(REFIID riid
, LPDIRECTSOUND8
*ppDS
);
436 DWORD
DSOUND_fraglen(DWORD nSamplesPerSec
, DWORD nBlockAlign
);
437 HRESULT
DSOUND_PrimaryCreate(DirectSoundDevice
*device
);
438 HRESULT
DSOUND_PrimaryDestroy(DirectSoundDevice
*device
);
439 HRESULT
DSOUND_PrimaryPlay(DirectSoundDevice
*device
);
440 HRESULT
DSOUND_PrimaryStop(DirectSoundDevice
*device
);
441 HRESULT
DSOUND_PrimaryGetPosition(DirectSoundDevice
*device
, LPDWORD playpos
, LPDWORD writepos
);
442 HRESULT
DSOUND_PrimarySetFormat(DirectSoundDevice
*device
, LPCWAVEFORMATEX wfex
, BOOL forced
);
443 HRESULT
DSOUND_ReopenDevice(DirectSoundDevice
*device
, BOOL forcewave
);
447 HRESULT
DSOUND_FullDuplexCreate(REFIID riid
, LPDIRECTSOUNDFULLDUPLEX
* ppDSFD
);
450 DWORD
DSOUND_bufpos_to_mixpos(const DirectSoundDevice
* device
, DWORD pos
);
451 void DSOUND_CheckEvent(const IDirectSoundBufferImpl
*dsb
, DWORD playpos
, int len
);
452 void DSOUND_RecalcVolPan(PDSVOLUMEPAN volpan
);
453 void DSOUND_AmpFactorToVolPan(PDSVOLUMEPAN volpan
);
454 void DSOUND_RecalcFormat(IDirectSoundBufferImpl
*dsb
);
455 void DSOUND_MixToTemporary(const IDirectSoundBufferImpl
*dsb
, DWORD writepos
, DWORD mixlen
, BOOL inmixer
);
456 DWORD
DSOUND_secpos_to_bufpos(const IDirectSoundBufferImpl
*dsb
, DWORD secpos
, DWORD secmixpos
, DWORD
* overshot
);
458 void CALLBACK
DSOUND_timer(UINT timerID
, UINT msg
, DWORD_PTR dwUser
, DWORD_PTR dw1
, DWORD_PTR dw2
);
459 void CALLBACK
DSOUND_callback(HWAVEOUT hwo
, UINT msg
, DWORD dwUser
, DWORD dw1
, DWORD dw2
);
463 void DSOUND_Calc3DBuffer(IDirectSoundBufferImpl
*dsb
);
467 HRESULT
DSOUND_CaptureCreate(REFIID riid
, LPDIRECTSOUNDCAPTURE
*ppDSC
);
468 HRESULT
DSOUND_CaptureCreate8(REFIID riid
, LPDIRECTSOUNDCAPTURE8
*ppDSC8
);
469 HRESULT WINAPI
IDirectSoundCaptureImpl_CreateCaptureBuffer(
470 LPDIRECTSOUNDCAPTURE iface
,
471 LPCDSCBUFFERDESC lpcDSCBufferDesc
,
472 LPDIRECTSOUNDCAPTUREBUFFER
* lplpDSCaptureBuffer
,
474 HRESULT WINAPI
IDirectSoundCaptureImpl_GetCaps(
475 LPDIRECTSOUNDCAPTURE iface
,
476 LPDSCCAPS lpDSCCaps
);
477 HRESULT WINAPI
IDirectSoundCaptureImpl_Initialize(
478 LPDIRECTSOUNDCAPTURE iface
,
481 #define STATE_STOPPED 0
482 #define STATE_STARTING 1
483 #define STATE_PLAYING 2
484 #define STATE_CAPTURING 2
485 #define STATE_STOPPING 3
487 #define DSOUND_FREQSHIFT (20)
489 extern DirectSoundDevice
* DSOUND_renderer
[MAXWAVEDRIVERS
];
490 extern GUID DSOUND_renderer_guids
[MAXWAVEDRIVERS
];
492 extern DirectSoundCaptureDevice
* DSOUND_capture
[MAXWAVEDRIVERS
];
493 extern GUID DSOUND_capture_guids
[MAXWAVEDRIVERS
];
495 HRESULT
mmErr(UINT err
);
496 void setup_dsound_options(void);
497 const char * dumpCooperativeLevel(DWORD level
);