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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 /* Linux does not support better timing than 10ms */
23 #define DS_TIME_RES 10 /* Resolution of multimedia timer */
24 #define DS_TIME_DEL 10 /* Delay of multimedia timer callback, and duration of HEL fragment */
26 #define DS_HEL_FRAGS 48 /* HEL only: number of waveOut fragments in primary buffer
27 * (changing this won't help you) */
29 /* direct sound hardware acceleration levels */
30 #define DS_HW_ACCEL_FULL 0 /* default on Windows 98 */
31 #define DS_HW_ACCEL_STANDARD 1 /* default on Windows 2000 */
32 #define DS_HW_ACCEL_BASIC 2
33 #define DS_HW_ACCEL_EMULATION 3
35 extern int ds_emuldriver
;
36 extern int ds_hel_margin
;
37 extern int ds_hel_queue
;
38 extern int ds_snd_queue_max
;
39 extern int ds_snd_queue_min
;
40 extern int ds_hw_accel
;
41 extern int ds_default_playback
;
42 extern int ds_default_capture
;
44 /*****************************************************************************
45 * Predeclare the interface implementation structures
47 typedef struct IDirectSoundImpl IDirectSoundImpl
;
48 typedef struct IDirectSound_IUnknown IDirectSound_IUnknown
;
49 typedef struct IDirectSound_IDirectSound IDirectSound_IDirectSound
;
50 typedef struct IDirectSound8_IUnknown IDirectSound8_IUnknown
;
51 typedef struct IDirectSound8_IDirectSound IDirectSound8_IDirectSound
;
52 typedef struct IDirectSound8_IDirectSound8 IDirectSound8_IDirectSound8
;
53 typedef struct IDirectSoundBufferImpl IDirectSoundBufferImpl
;
54 typedef struct IDirectSoundCaptureImpl IDirectSoundCaptureImpl
;
55 typedef struct IDirectSoundCaptureBufferImpl IDirectSoundCaptureBufferImpl
;
56 typedef struct IDirectSoundFullDuplexImpl IDirectSoundFullDuplexImpl
;
57 typedef struct IDirectSoundNotifyImpl IDirectSoundNotifyImpl
;
58 typedef struct IDirectSoundCaptureNotifyImpl IDirectSoundCaptureNotifyImpl
;
59 typedef struct IDirectSound3DListenerImpl IDirectSound3DListenerImpl
;
60 typedef struct IDirectSound3DBufferImpl IDirectSound3DBufferImpl
;
61 typedef struct IKsBufferPropertySetImpl IKsBufferPropertySetImpl
;
62 typedef struct IKsPrivatePropertySetImpl IKsPrivatePropertySetImpl
;
63 typedef struct PrimaryBufferImpl PrimaryBufferImpl
;
64 typedef struct SecondaryBufferImpl SecondaryBufferImpl
;
65 typedef struct IClassFactoryImpl IClassFactoryImpl
;
66 typedef struct DirectSoundDevice DirectSoundDevice
;
67 typedef struct DirectSoundCaptureDevice DirectSoundCaptureDevice
;
69 /*****************************************************************************
70 * IDirectSound implementation structure
72 struct IDirectSoundImpl
75 const IDirectSound8Vtbl
*lpVtbl
;
78 DirectSoundDevice
*device
;
84 struct DirectSoundDevice
95 LPWAVEHDR pwave
[DS_HEL_FRAGS
];
96 UINT timerID
, pwplay
, pwwrite
, pwqueue
, prebuf
, precount
;
98 PIDSDRIVERBUFFER hwbuf
;
100 DWORD writelead
, buflen
, state
, playpos
, mixpos
;
103 IDirectSoundBufferImpl
** buffers
;
104 RTL_RWLOCK buffer_list_lock
;
105 CRITICAL_SECTION mixlock
;
106 PrimaryBufferImpl
* primary
;
108 DWORD speaker_config
;
110 DWORD tmp_buffer_len
;
112 /* DirectSound3DListener fields */
113 IDirectSound3DListenerImpl
* listener
;
115 BOOL ds3dl_need_recalc
;
118 /* reference counted buffer memory for duplicated buffer memory */
119 typedef struct BufferMemory
125 HRESULT WINAPI
IDirectSoundImpl_Create(
126 LPDIRECTSOUND8
* ppds
);
128 HRESULT WINAPI
DSOUND_Create(
130 IUnknown
*pUnkOuter
);
132 HRESULT WINAPI
DSOUND_Create8(
133 LPDIRECTSOUND8
*ppDS
,
134 IUnknown
*pUnkOuter
);
136 /*****************************************************************************
137 * IDirectSound COM components
139 struct IDirectSound_IUnknown
{
140 const IUnknownVtbl
*lpVtbl
;
145 HRESULT WINAPI
IDirectSound_IUnknown_Create(
149 struct IDirectSound_IDirectSound
{
150 const IDirectSoundVtbl
*lpVtbl
;
155 HRESULT WINAPI
IDirectSound_IDirectSound_Create(
157 LPDIRECTSOUND
* ppds
);
159 /*****************************************************************************
160 * IDirectSound8 COM components
162 struct IDirectSound8_IUnknown
{
163 const IUnknownVtbl
*lpVtbl
;
168 HRESULT WINAPI
IDirectSound8_IUnknown_Create(
172 struct IDirectSound8_IDirectSound
{
173 const IDirectSoundVtbl
*lpVtbl
;
178 HRESULT WINAPI
IDirectSound8_IDirectSound_Create(
180 LPDIRECTSOUND
* ppds
);
182 struct IDirectSound8_IDirectSound8
{
183 const IDirectSound8Vtbl
*lpVtbl
;
188 HRESULT WINAPI
IDirectSound8_IDirectSound8_Create(
190 LPDIRECTSOUND8
* ppds
);
192 /*****************************************************************************
193 * IDirectSoundBuffer implementation structure
195 struct IDirectSoundBufferImpl
197 /* FIXME: document */
198 /* IUnknown fields */
199 const IDirectSoundBuffer8Vtbl
*lpVtbl
;
201 /* IDirectSoundBufferImpl fields */
202 SecondaryBufferImpl
* secondary
;
203 IDirectSoundImpl
* dsound
;
204 CRITICAL_SECTION lock
;
205 PIDSDRIVERBUFFER hwbuf
;
207 BufferMemory
* buffer
;
208 DWORD playflags
,state
,leadin
;
209 DWORD playpos
,startpos
,writelead
,buflen
;
210 DWORD nAvgBytesPerSec
;
212 DSVOLUMEPAN volpan
, cvolpan
;
214 /* used for frequency conversion (PerfectPitch) */
215 ULONG freqAdjust
, freqAcc
;
216 /* used for intelligent (well, sort of) prebuffering */
217 DWORD probably_valid_to
, last_playpos
;
218 DWORD primary_mixpos
, buf_mixpos
;
221 /* IDirectSoundNotifyImpl fields */
222 IDirectSoundNotifyImpl
* notify
;
223 LPDSBPOSITIONNOTIFY notifies
;
225 PIDSDRIVERNOTIFY hwnotify
;
227 /* DirectSound3DBuffer fields */
228 IDirectSound3DBufferImpl
* ds3db
;
229 DS3DBUFFER ds3db_ds3db
;
231 BOOL ds3db_need_recalc
;
233 /* IKsPropertySet fields */
234 IKsBufferPropertySetImpl
* iks
;
237 HRESULT WINAPI
IDirectSoundBufferImpl_Create(
238 IDirectSoundImpl
*ds
,
239 IDirectSoundBufferImpl
**pdsb
,
240 LPCDSBUFFERDESC dsbd
);
241 HRESULT WINAPI
IDirectSoundBufferImpl_Destroy(
242 IDirectSoundBufferImpl
*pdsb
);
244 /*****************************************************************************
245 * SecondaryBuffer implementation structure
247 struct SecondaryBufferImpl
249 const IDirectSoundBuffer8Vtbl
*lpVtbl
;
251 IDirectSoundBufferImpl
* dsb
;
254 HRESULT WINAPI
SecondaryBufferImpl_Create(
255 IDirectSoundBufferImpl
*dsb
,
256 SecondaryBufferImpl
**pdsb
);
257 HRESULT WINAPI
SecondaryBufferImpl_Destroy(
258 SecondaryBufferImpl
*pdsb
);
260 /*****************************************************************************
261 * PrimaryBuffer implementation structure
263 struct PrimaryBufferImpl
265 const IDirectSoundBuffer8Vtbl
*lpVtbl
;
267 IDirectSoundImpl
* dsound
;
270 HRESULT WINAPI
PrimaryBufferImpl_Create(
271 IDirectSoundImpl
*ds
,
272 PrimaryBufferImpl
**pdsb
,
273 LPCDSBUFFERDESC dsbd
);
275 /*****************************************************************************
276 * IDirectSoundCapture implementation structure
278 struct IDirectSoundCaptureImpl
280 /* IUnknown fields */
281 const IDirectSoundCaptureVtbl
*lpVtbl
;
284 DirectSoundCaptureDevice
*device
;
287 struct DirectSoundCaptureDevice
289 /* IDirectSoundCaptureImpl fields */
293 /* DirectSound driver stuff */
295 DSDRIVERDESC drvdesc
;
296 DSCDRIVERCAPS drvcaps
;
297 PIDSCDRIVERBUFFER hwbuf
;
299 /* wave driver info */
309 IDirectSoundCaptureBufferImpl
* capture_buffer
;
314 CRITICAL_SECTION lock
;
317 HRESULT WINAPI
IDirectSoundCaptureImpl_Create(
318 LPDIRECTSOUNDCAPTURE8
* ppds
);
320 HRESULT WINAPI
DSOUND_CaptureCreate(
321 LPDIRECTSOUNDCAPTURE
*ppDSC
,
322 IUnknown
*pUnkOuter
);
324 HRESULT WINAPI
DSOUND_CaptureCreate8(
325 LPDIRECTSOUNDCAPTURE8
*ppDSC8
,
326 IUnknown
*pUnkOuter
);
328 /*****************************************************************************
329 * IDirectSoundCaptureBuffer implementation structure
331 struct IDirectSoundCaptureBufferImpl
333 /* IUnknown fields */
334 const IDirectSoundCaptureBuffer8Vtbl
*lpVtbl
;
337 /* IDirectSoundCaptureBufferImpl fields */
338 IDirectSoundCaptureImpl
* dsound
;
339 /* FIXME: don't need this */
340 LPDSCBUFFERDESC pdscbd
;
343 /* IDirectSoundCaptureNotifyImpl fields */
344 IDirectSoundCaptureNotifyImpl
* notify
;
345 LPDSBPOSITIONNOTIFY notifies
;
347 PIDSDRIVERNOTIFY hwnotify
;
350 /*****************************************************************************
351 * IDirectSoundFullDuplex implementation structure
353 struct IDirectSoundFullDuplexImpl
355 /* IUnknown fields */
356 const IDirectSoundFullDuplexVtbl
*lpVtbl
;
359 /* IDirectSoundFullDuplexImpl fields */
362 /*****************************************************************************
363 * IDirectSoundNotify implementation structure
365 struct IDirectSoundNotifyImpl
367 /* IUnknown fields */
368 const IDirectSoundNotifyVtbl
*lpVtbl
;
370 IDirectSoundBufferImpl
* dsb
;
373 HRESULT WINAPI
IDirectSoundNotifyImpl_Create(
374 IDirectSoundBufferImpl
*dsb
,
375 IDirectSoundNotifyImpl
**pdsn
);
376 HRESULT WINAPI
IDirectSoundNotifyImpl_Destroy(
377 IDirectSoundNotifyImpl
*pdsn
);
379 /*****************************************************************************
380 * IDirectSoundCaptureNotify implementation structure
382 struct IDirectSoundCaptureNotifyImpl
384 /* IUnknown fields */
385 const IDirectSoundNotifyVtbl
*lpVtbl
;
387 IDirectSoundCaptureBufferImpl
* dscb
;
390 HRESULT WINAPI
IDirectSoundCaptureNotifyImpl_Create(
391 IDirectSoundCaptureBufferImpl
*dscb
,
392 IDirectSoundCaptureNotifyImpl
** pdscn
);
394 /*****************************************************************************
395 * IDirectSound3DListener implementation structure
397 struct IDirectSound3DListenerImpl
399 /* IUnknown fields */
400 const IDirectSound3DListenerVtbl
*lpVtbl
;
402 /* IDirectSound3DListenerImpl fields */
403 IDirectSoundImpl
* dsound
;
406 HRESULT WINAPI
IDirectSound3DListenerImpl_Create(
407 PrimaryBufferImpl
*pb
,
408 IDirectSound3DListenerImpl
**pdsl
);
410 /*****************************************************************************
411 * IKsBufferPropertySet implementation structure
413 struct IKsBufferPropertySetImpl
415 /* IUnknown fields */
416 const IKsPropertySetVtbl
*lpVtbl
;
418 /* IKsPropertySetImpl fields */
419 IDirectSoundBufferImpl
* dsb
;
422 HRESULT WINAPI
IKsBufferPropertySetImpl_Create(
423 IDirectSoundBufferImpl
*dsb
,
424 IKsBufferPropertySetImpl
**piks
);
425 HRESULT WINAPI
IKsBufferPropertySetImpl_Destroy(
426 IKsBufferPropertySetImpl
*piks
);
428 /*****************************************************************************
429 * IKsPrivatePropertySet implementation structure
431 struct IKsPrivatePropertySetImpl
433 /* IUnknown fields */
434 const IKsPropertySetVtbl
*lpVtbl
;
438 HRESULT WINAPI
IKsPrivatePropertySetImpl_Create(
439 IKsPrivatePropertySetImpl
**piks
);
441 /*****************************************************************************
442 * IDirectSound3DBuffer implementation structure
444 struct IDirectSound3DBufferImpl
446 /* IUnknown fields */
447 const IDirectSound3DBufferVtbl
*lpVtbl
;
449 /* IDirectSound3DBufferImpl fields */
450 IDirectSoundBufferImpl
* dsb
;
453 HRESULT WINAPI
IDirectSound3DBufferImpl_Create(
454 IDirectSoundBufferImpl
*dsb
,
455 IDirectSound3DBufferImpl
**pds3db
);
456 HRESULT WINAPI
IDirectSound3DBufferImpl_Destroy(
457 IDirectSound3DBufferImpl
*pds3db
);
459 /*******************************************************************************
460 * DirectSound ClassFactory implementation structure
462 struct IClassFactoryImpl
464 /* IUnknown fields */
465 const IClassFactoryVtbl
*lpVtbl
;
469 extern IClassFactoryImpl DSOUND_CAPTURE_CF
;
470 extern IClassFactoryImpl DSOUND_FULLDUPLEX_CF
;
472 void DSOUND_RecalcVolPan(PDSVOLUMEPAN volpan
);
473 void DSOUND_AmpFactorToVolPan(PDSVOLUMEPAN volpan
);
474 void DSOUND_RecalcFormat(IDirectSoundBufferImpl
*dsb
);
478 HRESULT
DSOUND_AddBuffer(IDirectSoundImpl
* pDS
, IDirectSoundBufferImpl
* pDSB
);
479 HRESULT
DSOUND_RemoveBuffer(IDirectSoundImpl
* pDS
, IDirectSoundBufferImpl
* pDSB
);
483 HRESULT
DSOUND_PrimaryCreate(DirectSoundDevice
*device
);
484 HRESULT
DSOUND_PrimaryDestroy(DirectSoundDevice
*device
);
485 HRESULT
DSOUND_PrimaryPlay(DirectSoundDevice
*device
);
486 HRESULT
DSOUND_PrimaryStop(DirectSoundDevice
*device
);
487 HRESULT
DSOUND_PrimaryGetPosition(DirectSoundDevice
*device
, LPDWORD playpos
, LPDWORD writepos
);
491 DWORD
DSOUND_CalcPlayPosition(IDirectSoundBufferImpl
*This
, DWORD pplay
, DWORD pwrite
);
495 void DSOUND_CheckEvent(IDirectSoundBufferImpl
*dsb
, int len
);
496 void DSOUND_ForceRemix(IDirectSoundBufferImpl
*dsb
);
497 void DSOUND_MixCancelAt(IDirectSoundBufferImpl
*dsb
, DWORD buf_writepos
);
498 void DSOUND_WaveQueue(DirectSoundDevice
*device
, DWORD mixq
);
499 void DSOUND_PerformMix(DirectSoundDevice
*device
);
500 void CALLBACK
DSOUND_timer(UINT timerID
, UINT msg
, DWORD dwUser
, DWORD dw1
, DWORD dw2
);
501 void CALLBACK
DSOUND_callback(HWAVEOUT hwo
, UINT msg
, DWORD dwUser
, DWORD dw1
, DWORD dw2
);
505 void DSOUND_Calc3DBuffer(IDirectSoundBufferImpl
*dsb
);
507 #define STATE_STOPPED 0
508 #define STATE_STARTING 1
509 #define STATE_PLAYING 2
510 #define STATE_CAPTURING 2
511 #define STATE_STOPPING 3
513 #define DSOUND_FREQSHIFT (14)
515 extern DirectSoundDevice
* DSOUND_renderer
[MAXWAVEDRIVERS
];
516 extern GUID DSOUND_renderer_guids
[MAXWAVEDRIVERS
];
518 extern DirectSoundCaptureDevice
* DSOUND_capture
[MAXWAVEDRIVERS
];
519 extern GUID DSOUND_capture_guids
[MAXWAVEDRIVERS
];
521 extern HRESULT
mmErr(UINT err
);
522 extern void setup_dsound_options(void);
523 extern const char * get_device_id(LPCGUID pGuid
);