[DSOUND]
[reactos.git] / reactos / dll / directx / wine / dsound / dsound_private.h
1 /* DirectSound
2 *
3 * Copyright 1998 Marcus Meissner
4 * Copyright 1998 Rob Riggs
5 * Copyright 2000-2001 TransGaming Technologies, Inc.
6 *
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.
11 *
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.
16 *
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
20 */
21
22 #include <wine/config.h>
23
24 #include <assert.h>
25 #include <math.h>
26 #include <stdarg.h>
27
28 #define WIN32_NO_STATUS
29 #define _INC_WINDOWS
30 #define COM_NO_WINDOWS_H
31
32 #define COBJMACROS
33 #define NONAMELESSSTRUCT
34 #define NONAMELESSUNION
35
36 #include <windef.h>
37 #include <winbase.h>
38 #include <winnls.h>
39 #include <wingdi.h>
40 #include <winternl.h>
41 #include <objbase.h>
42 #include <mmdeviceapi.h>
43 #include <audioclient.h>
44 #include <mmsystem.h>
45 #include <dsound.h>
46 #include <dsconf.h>
47 #include <vfwmsgs.h>
48 #include <devpkey.h>
49
50 #include <wine/debug.h>
51 #include <wine/list.h>
52
53 WINE_DEFAULT_DEBUG_CHANNEL(dsound);
54
55 /* Linux does not support better timing than 10ms */
56 #define DS_TIME_RES 2 /* Resolution of multimedia timer */
57 #define DS_TIME_DEL 10 /* Delay of multimedia timer callback, and duration of HEL fragment */
58
59 extern int ds_hel_buflen DECLSPEC_HIDDEN;
60 extern int ds_snd_queue_max DECLSPEC_HIDDEN;
61
62 /*****************************************************************************
63 * Predeclare the interface implementation structures
64 */
65 typedef struct IDirectSoundBufferImpl IDirectSoundBufferImpl;
66 typedef struct DirectSoundDevice DirectSoundDevice;
67
68 /* dsound_convert.h */
69 typedef float (*bitsgetfunc)(const IDirectSoundBufferImpl *, DWORD, DWORD);
70 typedef void (*bitsputfunc)(const IDirectSoundBufferImpl *, DWORD, DWORD, float);
71 extern const bitsgetfunc getbpp[5] DECLSPEC_HIDDEN;
72 void putieee32(const IDirectSoundBufferImpl *dsb, DWORD pos, DWORD channel, float value) DECLSPEC_HIDDEN;
73 void mixieee32(float *src, float *dst, unsigned samples) DECLSPEC_HIDDEN;
74 typedef void (*normfunc)(const void *, void *, unsigned);
75 extern const normfunc normfunctions[5] DECLSPEC_HIDDEN;
76
77 typedef struct _DSVOLUMEPAN
78 {
79 DWORD dwTotalLeftAmpFactor;
80 DWORD dwTotalRightAmpFactor;
81 LONG lVolume;
82 DWORD dwVolAmpFactor;
83 LONG lPan;
84 DWORD dwPanLeftAmpFactor;
85 DWORD dwPanRightAmpFactor;
86 } DSVOLUMEPAN,*PDSVOLUMEPAN;
87
88 /*****************************************************************************
89 * IDirectSoundDevice implementation structure
90 */
91 struct DirectSoundDevice
92 {
93 LONG ref;
94
95 GUID guid;
96 DSCAPS drvcaps;
97 DWORD priolevel, sleeptime;
98 PWAVEFORMATEX pwfx, primary_pwfx;
99 UINT playing_offs_bytes, in_mmdev_bytes, prebuf;
100 DWORD fraglen;
101 LPBYTE buffer;
102 DWORD writelead, buflen, state, playpos, mixpos;
103 int nrofbuffers;
104 IDirectSoundBufferImpl** buffers;
105 RTL_RWLOCK buffer_list_lock;
106 CRITICAL_SECTION mixlock;
107 IDirectSoundBufferImpl *primary;
108 DWORD speaker_config;
109 float *mix_buffer, *tmp_buffer;
110 DWORD tmp_buffer_len, mix_buffer_len;
111
112 DSVOLUMEPAN volpan;
113
114 normfunc normfunction;
115
116 /* DirectSound3DListener fields */
117 DS3DLISTENER ds3dl;
118 BOOL ds3dl_need_recalc;
119
120 IMMDevice *mmdevice;
121 IAudioClient *client;
122 IAudioClock *clock;
123 IAudioStreamVolume *volume;
124 IAudioRenderClient *render;
125
126 HANDLE sleepev, thread;
127 struct list entry;
128 };
129
130 /* reference counted buffer memory for duplicated buffer memory */
131 typedef struct BufferMemory
132 {
133 LONG ref;
134 LPBYTE memory;
135 struct list buffers;
136 } BufferMemory;
137
138 ULONG DirectSoundDevice_Release(DirectSoundDevice * device) DECLSPEC_HIDDEN;
139 HRESULT DirectSoundDevice_Initialize(
140 DirectSoundDevice ** ppDevice,
141 LPCGUID lpcGUID) DECLSPEC_HIDDEN;
142 HRESULT DirectSoundDevice_AddBuffer(
143 DirectSoundDevice * device,
144 IDirectSoundBufferImpl * pDSB) DECLSPEC_HIDDEN;
145 void DirectSoundDevice_RemoveBuffer(DirectSoundDevice * device, IDirectSoundBufferImpl * pDSB) DECLSPEC_HIDDEN;
146 HRESULT DirectSoundDevice_CreateSoundBuffer(
147 DirectSoundDevice * device,
148 LPCDSBUFFERDESC dsbd,
149 LPLPDIRECTSOUNDBUFFER ppdsb,
150 LPUNKNOWN lpunk,
151 BOOL from8) DECLSPEC_HIDDEN;
152 HRESULT DirectSoundDevice_DuplicateSoundBuffer(
153 DirectSoundDevice * device,
154 LPDIRECTSOUNDBUFFER psb,
155 LPLPDIRECTSOUNDBUFFER ppdsb) DECLSPEC_HIDDEN;
156
157 /*****************************************************************************
158 * IDirectSoundBuffer implementation structure
159 */
160 struct IDirectSoundBufferImpl
161 {
162 IDirectSoundBuffer8 IDirectSoundBuffer8_iface;
163 IDirectSoundNotify IDirectSoundNotify_iface;
164 IDirectSound3DListener IDirectSound3DListener_iface; /* only primary buffer */
165 IDirectSound3DBuffer IDirectSound3DBuffer_iface; /* only secondary buffer */
166 IKsPropertySet IKsPropertySet_iface;
167 LONG numIfaces; /* "in use interfaces" refcount */
168 LONG ref, refn, ref3D, refiks;
169 /* IDirectSoundBufferImpl fields */
170 DirectSoundDevice* device;
171 RTL_RWLOCK lock;
172 PWAVEFORMATEX pwfx;
173 BufferMemory* buffer;
174 DWORD playflags,state,leadin;
175 DWORD writelead,buflen;
176 DWORD nAvgBytesPerSec;
177 DWORD freq;
178 DSVOLUMEPAN volpan;
179 DSBUFFERDESC dsbd;
180 /* used for frequency conversion (PerfectPitch) */
181 ULONG freqneeded;
182 DWORD firstep;
183 float freqAcc, freqAdjust, firgain;
184 /* used for mixing */
185 DWORD sec_mixpos;
186
187 /* IDirectSoundNotify fields */
188 LPDSBPOSITIONNOTIFY notifies;
189 int nrofnotifies;
190 /* DirectSound3DBuffer fields */
191 DS3DBUFFER ds3db_ds3db;
192 LONG ds3db_lVolume;
193 BOOL ds3db_need_recalc;
194 /* Used for bit depth conversion */
195 int mix_channels;
196 bitsgetfunc get, get_aux;
197 bitsputfunc put, put_aux;
198
199 struct list entry;
200 };
201
202 float get_mono(const IDirectSoundBufferImpl *dsb, DWORD pos, DWORD channel) DECLSPEC_HIDDEN;
203 void put_mono2stereo(const IDirectSoundBufferImpl *dsb, DWORD pos, DWORD channel, float value) DECLSPEC_HIDDEN;
204
205 HRESULT IDirectSoundBufferImpl_Create(
206 DirectSoundDevice *device,
207 IDirectSoundBufferImpl **ppdsb,
208 LPCDSBUFFERDESC dsbd) DECLSPEC_HIDDEN;
209 HRESULT IDirectSoundBufferImpl_Duplicate(
210 DirectSoundDevice *device,
211 IDirectSoundBufferImpl **ppdsb,
212 IDirectSoundBufferImpl *pdsb) DECLSPEC_HIDDEN;
213 void secondarybuffer_destroy(IDirectSoundBufferImpl *This) DECLSPEC_HIDDEN;
214 const IDirectSound3DListenerVtbl ds3dlvt DECLSPEC_HIDDEN;
215 const IDirectSound3DBufferVtbl ds3dbvt DECLSPEC_HIDDEN;
216 const IKsPropertySetVtbl iksbvt DECLSPEC_HIDDEN;
217
218 HRESULT IKsPrivatePropertySetImpl_Create(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
219
220 /*******************************************************************************
221 */
222
223 /* dsound.c */
224
225 HRESULT DSOUND_Create(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
226 HRESULT DSOUND_Create8(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
227 HRESULT IDirectSoundImpl_Create(IUnknown *outer_unk, REFIID riid, void **ppv, BOOL has_ds8) DECLSPEC_HIDDEN;
228
229 /* primary.c */
230
231 HRESULT DSOUND_PrimaryCreate(DirectSoundDevice *device) DECLSPEC_HIDDEN;
232 HRESULT DSOUND_PrimaryDestroy(DirectSoundDevice *device) DECLSPEC_HIDDEN;
233 HRESULT DSOUND_PrimaryPlay(DirectSoundDevice *device) DECLSPEC_HIDDEN;
234 HRESULT DSOUND_PrimaryStop(DirectSoundDevice *device) DECLSPEC_HIDDEN;
235 HRESULT DSOUND_PrimaryGetPosition(DirectSoundDevice *device, LPDWORD playpos, LPDWORD writepos) DECLSPEC_HIDDEN;
236 LPWAVEFORMATEX DSOUND_CopyFormat(LPCWAVEFORMATEX wfex) DECLSPEC_HIDDEN;
237 HRESULT DSOUND_ReopenDevice(DirectSoundDevice *device, BOOL forcewave) DECLSPEC_HIDDEN;
238 HRESULT DSOUND_PrimaryOpen(DirectSoundDevice *device) DECLSPEC_HIDDEN;
239 HRESULT primarybuffer_create(DirectSoundDevice *device, IDirectSoundBufferImpl **ppdsb,
240 const DSBUFFERDESC *dsbd) DECLSPEC_HIDDEN;
241 void primarybuffer_destroy(IDirectSoundBufferImpl *This) DECLSPEC_HIDDEN;
242 HRESULT primarybuffer_SetFormat(DirectSoundDevice *device, LPCWAVEFORMATEX wfex) DECLSPEC_HIDDEN;
243 LONG capped_refcount_dec(LONG *ref) DECLSPEC_HIDDEN;
244
245 /* duplex.c */
246
247 HRESULT DSOUND_FullDuplexCreate(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
248
249 /* mixer.c */
250 void DSOUND_CheckEvent(const IDirectSoundBufferImpl *dsb, DWORD playpos, int len) DECLSPEC_HIDDEN;
251 void DSOUND_RecalcVolPan(PDSVOLUMEPAN volpan) DECLSPEC_HIDDEN;
252 void DSOUND_AmpFactorToVolPan(PDSVOLUMEPAN volpan) DECLSPEC_HIDDEN;
253 void DSOUND_RecalcFormat(IDirectSoundBufferImpl *dsb) DECLSPEC_HIDDEN;
254 DWORD DSOUND_secpos_to_bufpos(const IDirectSoundBufferImpl *dsb, DWORD secpos, DWORD secmixpos, float *overshot) DECLSPEC_HIDDEN;
255
256 DWORD CALLBACK DSOUND_mixthread(void *ptr) DECLSPEC_HIDDEN;
257
258 /* sound3d.c */
259
260 void DSOUND_Calc3DBuffer(IDirectSoundBufferImpl *dsb) DECLSPEC_HIDDEN;
261
262 /* capture.c */
263
264 HRESULT DSOUND_CaptureCreate(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
265 HRESULT DSOUND_CaptureCreate8(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
266 HRESULT IDirectSoundCaptureImpl_Create(IUnknown *outer_unk, REFIID riid, void **ppv, BOOL has_dsc8) DECLSPEC_HIDDEN;
267
268 #define STATE_STOPPED 0
269 #define STATE_STARTING 1
270 #define STATE_PLAYING 2
271 #define STATE_CAPTURING 2
272 #define STATE_STOPPING 3
273
274 extern CRITICAL_SECTION DSOUND_renderers_lock DECLSPEC_HIDDEN;
275 extern CRITICAL_SECTION DSOUND_capturers_lock DECLSPEC_HIDDEN;
276 extern struct list DSOUND_capturers DECLSPEC_HIDDEN;
277 extern struct list DSOUND_renderers DECLSPEC_HIDDEN;
278
279 extern GUID DSOUND_renderer_guids[MAXWAVEDRIVERS] DECLSPEC_HIDDEN;
280 extern GUID DSOUND_capture_guids[MAXWAVEDRIVERS] DECLSPEC_HIDDEN;
281
282 extern WCHAR wine_vxd_drv[] DECLSPEC_HIDDEN;
283
284 void setup_dsound_options(void) DECLSPEC_HIDDEN;
285
286 HRESULT get_mmdevice(EDataFlow flow, const GUID *tgt, IMMDevice **device) DECLSPEC_HIDDEN;
287
288 BOOL DSOUND_check_supported(IAudioClient *client, DWORD rate,
289 DWORD depth, WORD channels) DECLSPEC_HIDDEN;
290 UINT DSOUND_create_timer(LPTIMECALLBACK cb, DWORD_PTR user) DECLSPEC_HIDDEN;
291 HRESULT enumerate_mmdevices(EDataFlow flow, GUID *guids,
292 LPDSENUMCALLBACKW cb, void *user) DECLSPEC_HIDDEN;