1 /*==========================================================================;
2  *
3  *  Copyright (c) Microsoft Corporation.  All rights reserved.
4  *
5  *  File:       dsound.h
6  *  Content:    DirectSound include file
7  *
8  **************************************************************************/
9 
10 #define COM_NO_WINDOWS_H
11 #include <objbase.h>
12 #include <float.h>
13 
14 #ifndef DIRECTSOUND_VERSION
15 #define DIRECTSOUND_VERSION 0x0900  /* Version 9.0 */
16 #endif
17 
18 #ifdef __cplusplus
19 extern "C" {
20 #endif // __cplusplus
21 
22 #ifndef __DSOUND_INCLUDED__
23 #define __DSOUND_INCLUDED__
24 
25 /* Type definitions shared with Direct3D */
26 
27 #ifndef DX_SHARED_DEFINES
28 
29 typedef float D3DVALUE, *LPD3DVALUE;
30 
31 #ifndef D3DCOLOR_DEFINED
32 typedef DWORD D3DCOLOR;
33 #define D3DCOLOR_DEFINED
34 #endif
35 
36 #ifndef LPD3DCOLOR_DEFINED
37 typedef DWORD *LPD3DCOLOR;
38 #define LPD3DCOLOR_DEFINED
39 #endif
40 
41 #ifndef D3DVECTOR_DEFINED
42 typedef struct _D3DVECTOR {
43     float x;
44     float y;
45     float z;
46 } D3DVECTOR;
47 #define D3DVECTOR_DEFINED
48 #endif
49 
50 #ifndef LPD3DVECTOR_DEFINED
51 typedef D3DVECTOR *LPD3DVECTOR;
52 #define LPD3DVECTOR_DEFINED
53 #endif
54 
55 #define DX_SHARED_DEFINES
56 #endif // DX_SHARED_DEFINES
57 
58 #define _FACDS  0x878   /* DirectSound's facility code */
59 #define MAKE_DSHRESULT(code)  MAKE_HRESULT(1, _FACDS, code)
60 
61 // DirectSound Component GUID {47D4D946-62E8-11CF-93BC-444553540000}
62 DEFINE_GUID(CLSID_DirectSound, 0x47d4d946, 0x62e8, 0x11cf, 0x93, 0xbc, 0x44, 0x45, 0x53, 0x54, 0x0, 0x0);
63 
64 // DirectSound 8.0 Component GUID {3901CC3F-84B5-4FA4-BA35-AA8172B8A09B}
65 DEFINE_GUID(CLSID_DirectSound8, 0x3901cc3f, 0x84b5, 0x4fa4, 0xba, 0x35, 0xaa, 0x81, 0x72, 0xb8, 0xa0, 0x9b);
66 
67 // DirectSound Capture Component GUID {B0210780-89CD-11D0-AF08-00A0C925CD16}
68 DEFINE_GUID(CLSID_DirectSoundCapture, 0xb0210780, 0x89cd, 0x11d0, 0xaf, 0x8, 0x0, 0xa0, 0xc9, 0x25, 0xcd, 0x16);
69 
70 // DirectSound 8.0 Capture Component GUID {E4BCAC13-7F99-4908-9A8E-74E3BF24B6E1}
71 DEFINE_GUID(CLSID_DirectSoundCapture8, 0xe4bcac13, 0x7f99, 0x4908, 0x9a, 0x8e, 0x74, 0xe3, 0xbf, 0x24, 0xb6, 0xe1);
72 
73 // DirectSound Full Duplex Component GUID {FEA4300C-7959-4147-B26A-2377B9E7A91D}
74 DEFINE_GUID(CLSID_DirectSoundFullDuplex, 0xfea4300c, 0x7959, 0x4147, 0xb2, 0x6a, 0x23, 0x77, 0xb9, 0xe7, 0xa9, 0x1d);
75 
76 
77 // DirectSound default playback device GUID {DEF00000-9C6D-47ED-AAF1-4DDA8F2B5C03}
78 DEFINE_GUID(DSDEVID_DefaultPlayback, 0xdef00000, 0x9c6d, 0x47ed, 0xaa, 0xf1, 0x4d, 0xda, 0x8f, 0x2b, 0x5c, 0x03);
79 
80 // DirectSound default capture device GUID {DEF00001-9C6D-47ED-AAF1-4DDA8F2B5C03}
81 DEFINE_GUID(DSDEVID_DefaultCapture, 0xdef00001, 0x9c6d, 0x47ed, 0xaa, 0xf1, 0x4d, 0xda, 0x8f, 0x2b, 0x5c, 0x03);
82 
83 // DirectSound default device for voice playback {DEF00002-9C6D-47ED-AAF1-4DDA8F2B5C03}
84 DEFINE_GUID(DSDEVID_DefaultVoicePlayback, 0xdef00002, 0x9c6d, 0x47ed, 0xaa, 0xf1, 0x4d, 0xda, 0x8f, 0x2b, 0x5c, 0x03);
85 
86 // DirectSound default device for voice capture {DEF00003-9C6D-47ED-AAF1-4DDA8F2B5C03}
87 DEFINE_GUID(DSDEVID_DefaultVoiceCapture, 0xdef00003, 0x9c6d, 0x47ed, 0xaa, 0xf1, 0x4d, 0xda, 0x8f, 0x2b, 0x5c, 0x03);
88 
89 
90 //
91 // Forward declarations for interfaces.
92 // 'struct' not 'class' per the way DECLARE_INTERFACE_ is defined
93 //
94 
95 #ifdef __cplusplus
96 struct IDirectSound;
97 struct IDirectSoundBuffer;
98 struct IDirectSound3DListener;
99 struct IDirectSound3DBuffer;
100 struct IDirectSoundCapture;
101 struct IDirectSoundCaptureBuffer;
102 struct IDirectSoundNotify;
103 #endif // __cplusplus
104 
105 
106 //
107 // DirectSound 8.0 interfaces.
108 //
109 
110 #if DIRECTSOUND_VERSION >= 0x0800
111 
112 #ifdef __cplusplus
113 struct IDirectSound8;
114 struct IDirectSoundBuffer8;
115 struct IDirectSoundCaptureBuffer8;
116 struct IDirectSoundFXGargle;
117 struct IDirectSoundFXChorus;
118 struct IDirectSoundFXFlanger;
119 struct IDirectSoundFXEcho;
120 struct IDirectSoundFXDistortion;
121 struct IDirectSoundFXCompressor;
122 struct IDirectSoundFXParamEq;
123 struct IDirectSoundFXWavesReverb;
124 struct IDirectSoundFXI3DL2Reverb;
125 struct IDirectSoundCaptureFXAec;
126 struct IDirectSoundCaptureFXNoiseSuppress;
127 struct IDirectSoundFullDuplex;
128 #endif // __cplusplus
129 
130 // IDirectSound8, IDirectSoundBuffer8 and IDirectSoundCaptureBuffer8 are the
131 // only DirectSound 7.0 interfaces with changed functionality in version 8.0.
132 // The other level 8 interfaces as equivalent to their level 7 counterparts:
133 
134 #define IDirectSoundCapture8            IDirectSoundCapture
135 #define IDirectSound3DListener8         IDirectSound3DListener
136 #define IDirectSound3DBuffer8           IDirectSound3DBuffer
137 #define IDirectSoundNotify8             IDirectSoundNotify
138 #define IDirectSoundFXGargle8           IDirectSoundFXGargle
139 #define IDirectSoundFXChorus8           IDirectSoundFXChorus
140 #define IDirectSoundFXFlanger8          IDirectSoundFXFlanger
141 #define IDirectSoundFXEcho8             IDirectSoundFXEcho
142 #define IDirectSoundFXDistortion8       IDirectSoundFXDistortion
143 #define IDirectSoundFXCompressor8       IDirectSoundFXCompressor
144 #define IDirectSoundFXParamEq8          IDirectSoundFXParamEq
145 #define IDirectSoundFXWavesReverb8      IDirectSoundFXWavesReverb
146 #define IDirectSoundFXI3DL2Reverb8      IDirectSoundFXI3DL2Reverb
147 #define IDirectSoundCaptureFXAec8       IDirectSoundCaptureFXAec
148 #define IDirectSoundCaptureFXNoiseSuppress8 IDirectSoundCaptureFXNoiseSuppress
149 #define IDirectSoundFullDuplex8         IDirectSoundFullDuplex
150 
151 #endif // DIRECTSOUND_VERSION >= 0x0800
152 
153 typedef struct IDirectSound                 *LPDIRECTSOUND;
154 typedef struct IDirectSoundBuffer           *LPDIRECTSOUNDBUFFER;
155 typedef struct IDirectSound3DListener       *LPDIRECTSOUND3DLISTENER;
156 typedef struct IDirectSound3DBuffer         *LPDIRECTSOUND3DBUFFER;
157 typedef struct IDirectSoundCapture          *LPDIRECTSOUNDCAPTURE;
158 typedef struct IDirectSoundCaptureBuffer    *LPDIRECTSOUNDCAPTUREBUFFER;
159 typedef struct IDirectSoundNotify           *LPDIRECTSOUNDNOTIFY;
160 
161 
162 #if DIRECTSOUND_VERSION >= 0x0800
163 
164 typedef struct IDirectSoundFXGargle         *LPDIRECTSOUNDFXGARGLE;
165 typedef struct IDirectSoundFXChorus         *LPDIRECTSOUNDFXCHORUS;
166 typedef struct IDirectSoundFXFlanger        *LPDIRECTSOUNDFXFLANGER;
167 typedef struct IDirectSoundFXEcho           *LPDIRECTSOUNDFXECHO;
168 typedef struct IDirectSoundFXDistortion     *LPDIRECTSOUNDFXDISTORTION;
169 typedef struct IDirectSoundFXCompressor     *LPDIRECTSOUNDFXCOMPRESSOR;
170 typedef struct IDirectSoundFXParamEq        *LPDIRECTSOUNDFXPARAMEQ;
171 typedef struct IDirectSoundFXWavesReverb    *LPDIRECTSOUNDFXWAVESREVERB;
172 typedef struct IDirectSoundFXI3DL2Reverb    *LPDIRECTSOUNDFXI3DL2REVERB;
173 typedef struct IDirectSoundCaptureFXAec     *LPDIRECTSOUNDCAPTUREFXAEC;
174 typedef struct IDirectSoundCaptureFXNoiseSuppress *LPDIRECTSOUNDCAPTUREFXNOISESUPPRESS;
175 typedef struct IDirectSoundFullDuplex       *LPDIRECTSOUNDFULLDUPLEX;
176 
177 typedef struct IDirectSound8                *LPDIRECTSOUND8;
178 typedef struct IDirectSoundBuffer8          *LPDIRECTSOUNDBUFFER8;
179 typedef struct IDirectSound3DListener8      *LPDIRECTSOUND3DLISTENER8;
180 typedef struct IDirectSound3DBuffer8        *LPDIRECTSOUND3DBUFFER8;
181 typedef struct IDirectSoundCapture8         *LPDIRECTSOUNDCAPTURE8;
182 typedef struct IDirectSoundCaptureBuffer8   *LPDIRECTSOUNDCAPTUREBUFFER8;
183 typedef struct IDirectSoundNotify8          *LPDIRECTSOUNDNOTIFY8;
184 typedef struct IDirectSoundFXGargle8        *LPDIRECTSOUNDFXGARGLE8;
185 typedef struct IDirectSoundFXChorus8        *LPDIRECTSOUNDFXCHORUS8;
186 typedef struct IDirectSoundFXFlanger8       *LPDIRECTSOUNDFXFLANGER8;
187 typedef struct IDirectSoundFXEcho8          *LPDIRECTSOUNDFXECHO8;
188 typedef struct IDirectSoundFXDistortion8    *LPDIRECTSOUNDFXDISTORTION8;
189 typedef struct IDirectSoundFXCompressor8    *LPDIRECTSOUNDFXCOMPRESSOR8;
190 typedef struct IDirectSoundFXParamEq8       *LPDIRECTSOUNDFXPARAMEQ8;
191 typedef struct IDirectSoundFXWavesReverb8   *LPDIRECTSOUNDFXWAVESREVERB8;
192 typedef struct IDirectSoundFXI3DL2Reverb8   *LPDIRECTSOUNDFXI3DL2REVERB8;
193 typedef struct IDirectSoundCaptureFXAec8    *LPDIRECTSOUNDCAPTUREFXAEC8;
194 typedef struct IDirectSoundCaptureFXNoiseSuppress8 *LPDIRECTSOUNDCAPTUREFXNOISESUPPRESS8;
195 typedef struct IDirectSoundFullDuplex8      *LPDIRECTSOUNDFULLDUPLEX8;
196 
197 #endif // DIRECTSOUND_VERSION >= 0x0800
198 
199 //
200 // IID definitions for the unchanged DirectSound 8.0 interfaces
201 //
202 
203 #if DIRECTSOUND_VERSION >= 0x0800
204 
205 #define IID_IDirectSoundCapture8            IID_IDirectSoundCapture
206 #define IID_IDirectSound3DListener8         IID_IDirectSound3DListener
207 #define IID_IDirectSound3DBuffer8           IID_IDirectSound3DBuffer
208 #define IID_IDirectSoundNotify8             IID_IDirectSoundNotify
209 #define IID_IDirectSoundFXGargle8           IID_IDirectSoundFXGargle
210 #define IID_IDirectSoundFXChorus8           IID_IDirectSoundFXChorus
211 #define IID_IDirectSoundFXFlanger8          IID_IDirectSoundFXFlanger
212 #define IID_IDirectSoundFXEcho8             IID_IDirectSoundFXEcho
213 #define IID_IDirectSoundFXDistortion8       IID_IDirectSoundFXDistortion
214 #define IID_IDirectSoundFXCompressor8       IID_IDirectSoundFXCompressor
215 #define IID_IDirectSoundFXParamEq8          IID_IDirectSoundFXParamEq
216 #define IID_IDirectSoundFXWavesReverb8      IID_IDirectSoundFXWavesReverb
217 #define IID_IDirectSoundFXI3DL2Reverb8      IID_IDirectSoundFXI3DL2Reverb
218 #define IID_IDirectSoundCaptureFXAec8       IID_IDirectSoundCaptureFXAec
219 #define IID_IDirectSoundCaptureFXNoiseSuppress8 IID_IDirectSoundCaptureFXNoiseSuppress
220 #define IID_IDirectSoundFullDuplex8         IID_IDirectSoundFullDuplex
221 
222 #endif // DIRECTSOUND_VERSION >= 0x0800
223 
224 //
225 // Compatibility typedefs
226 //
227 
228 #ifndef _LPCWAVEFORMATEX_DEFINED
229 #define _LPCWAVEFORMATEX_DEFINED
230 typedef const WAVEFORMATEX *LPCWAVEFORMATEX;
231 #endif // _LPCWAVEFORMATEX_DEFINED
232 
233 #ifndef __LPCGUID_DEFINED__
234 #define __LPCGUID_DEFINED__
235 typedef const GUID *LPCGUID;
236 #endif // __LPCGUID_DEFINED__
237 
238 typedef LPDIRECTSOUND *LPLPDIRECTSOUND;
239 typedef LPDIRECTSOUNDBUFFER *LPLPDIRECTSOUNDBUFFER;
240 typedef LPDIRECTSOUND3DLISTENER *LPLPDIRECTSOUND3DLISTENER;
241 typedef LPDIRECTSOUND3DBUFFER *LPLPDIRECTSOUND3DBUFFER;
242 typedef LPDIRECTSOUNDCAPTURE *LPLPDIRECTSOUNDCAPTURE;
243 typedef LPDIRECTSOUNDCAPTUREBUFFER *LPLPDIRECTSOUNDCAPTUREBUFFER;
244 typedef LPDIRECTSOUNDNOTIFY *LPLPDIRECTSOUNDNOTIFY;
245 
246 #if DIRECTSOUND_VERSION >= 0x0800
247 typedef LPDIRECTSOUND8 *LPLPDIRECTSOUND8;
248 typedef LPDIRECTSOUNDBUFFER8 *LPLPDIRECTSOUNDBUFFER8;
249 typedef LPDIRECTSOUNDCAPTURE8 *LPLPDIRECTSOUNDCAPTURE8;
250 typedef LPDIRECTSOUNDCAPTUREBUFFER8 *LPLPDIRECTSOUNDCAPTUREBUFFER8;
251 #endif // DIRECTSOUND_VERSION >= 0x0800
252 
253 //
254 // Structures
255 //
256 
257 typedef struct _DSCAPS
258 {
259     DWORD           dwSize;
260     DWORD           dwFlags;
261     DWORD           dwMinSecondarySampleRate;
262     DWORD           dwMaxSecondarySampleRate;
263     DWORD           dwPrimaryBuffers;
264     DWORD           dwMaxHwMixingAllBuffers;
265     DWORD           dwMaxHwMixingStaticBuffers;
266     DWORD           dwMaxHwMixingStreamingBuffers;
267     DWORD           dwFreeHwMixingAllBuffers;
268     DWORD           dwFreeHwMixingStaticBuffers;
269     DWORD           dwFreeHwMixingStreamingBuffers;
270     DWORD           dwMaxHw3DAllBuffers;
271     DWORD           dwMaxHw3DStaticBuffers;
272     DWORD           dwMaxHw3DStreamingBuffers;
273     DWORD           dwFreeHw3DAllBuffers;
274     DWORD           dwFreeHw3DStaticBuffers;
275     DWORD           dwFreeHw3DStreamingBuffers;
276     DWORD           dwTotalHwMemBytes;
277     DWORD           dwFreeHwMemBytes;
278     DWORD           dwMaxContigFreeHwMemBytes;
279     DWORD           dwUnlockTransferRateHwBuffers;
280     DWORD           dwPlayCpuOverheadSwBuffers;
281     DWORD           dwReserved1;
282     DWORD           dwReserved2;
283 } DSCAPS, *LPDSCAPS;
284 
285 typedef const DSCAPS *LPCDSCAPS;
286 
287 typedef struct _DSBCAPS
288 {
289     DWORD           dwSize;
290     DWORD           dwFlags;
291     DWORD           dwBufferBytes;
292     DWORD           dwUnlockTransferRate;
293     DWORD           dwPlayCpuOverhead;
294 } DSBCAPS, *LPDSBCAPS;
295 
296 typedef const DSBCAPS *LPCDSBCAPS;
297 
298 #if DIRECTSOUND_VERSION >= 0x0800
299 
300     typedef struct _DSEFFECTDESC
301     {
302         DWORD       dwSize;
303         DWORD       dwFlags;
304         GUID        guidDSFXClass;
305         DWORD_PTR   dwReserved1;
306         DWORD_PTR   dwReserved2;
307     } DSEFFECTDESC, *LPDSEFFECTDESC;
308     typedef const DSEFFECTDESC *LPCDSEFFECTDESC;
309 
310     #define DSFX_LOCHARDWARE    0x00000001
311     #define DSFX_LOCSOFTWARE    0x00000002
312 
313     enum
314     {
315         DSFXR_PRESENT,          // 0
316         DSFXR_LOCHARDWARE,      // 1
317         DSFXR_LOCSOFTWARE,      // 2
318         DSFXR_UNALLOCATED,      // 3
319         DSFXR_FAILED,           // 4
320         DSFXR_UNKNOWN,          // 5
321         DSFXR_SENDLOOP          // 6
322     };
323 
324     typedef struct _DSCEFFECTDESC
325     {
326         DWORD       dwSize;
327         DWORD       dwFlags;
328         GUID        guidDSCFXClass;
329         GUID        guidDSCFXInstance;
330         DWORD       dwReserved1;
331         DWORD       dwReserved2;
332     } DSCEFFECTDESC, *LPDSCEFFECTDESC;
333     typedef const DSCEFFECTDESC *LPCDSCEFFECTDESC;
334 
335     #define DSCFX_LOCHARDWARE   0x00000001
336     #define DSCFX_LOCSOFTWARE   0x00000002
337 
338     #define DSCFXR_LOCHARDWARE  0x00000010
339     #define DSCFXR_LOCSOFTWARE  0x00000020
340 
341 #endif // DIRECTSOUND_VERSION >= 0x0800
342 
343 typedef struct _DSBUFFERDESC
344 {
345     DWORD           dwSize;
346     DWORD           dwFlags;
347     DWORD           dwBufferBytes;
348     DWORD           dwReserved;
349     LPWAVEFORMATEX  lpwfxFormat;
350 #if DIRECTSOUND_VERSION >= 0x0700
351     GUID            guid3DAlgorithm;
352 #endif
353 } DSBUFFERDESC, *LPDSBUFFERDESC;
354 
355 typedef const DSBUFFERDESC *LPCDSBUFFERDESC;
356 
357 // Older version of this structure:
358 
359 typedef struct _DSBUFFERDESC1
360 {
361     DWORD           dwSize;
362     DWORD           dwFlags;
363     DWORD           dwBufferBytes;
364     DWORD           dwReserved;
365     LPWAVEFORMATEX  lpwfxFormat;
366 } DSBUFFERDESC1, *LPDSBUFFERDESC1;
367 
368 typedef const DSBUFFERDESC1 *LPCDSBUFFERDESC1;
369 
370 typedef struct _DS3DBUFFER
371 {
372     DWORD           dwSize;
373     D3DVECTOR       vPosition;
374     D3DVECTOR       vVelocity;
375     DWORD           dwInsideConeAngle;
376     DWORD           dwOutsideConeAngle;
377     D3DVECTOR       vConeOrientation;
378     LONG            lConeOutsideVolume;
379     D3DVALUE        flMinDistance;
380     D3DVALUE        flMaxDistance;
381     DWORD           dwMode;
382 } DS3DBUFFER, *LPDS3DBUFFER;
383 
384 typedef const DS3DBUFFER *LPCDS3DBUFFER;
385 
386 typedef struct _DS3DLISTENER
387 {
388     DWORD           dwSize;
389     D3DVECTOR       vPosition;
390     D3DVECTOR       vVelocity;
391     D3DVECTOR       vOrientFront;
392     D3DVECTOR       vOrientTop;
393     D3DVALUE        flDistanceFactor;
394     D3DVALUE        flRolloffFactor;
395     D3DVALUE        flDopplerFactor;
396 } DS3DLISTENER, *LPDS3DLISTENER;
397 
398 typedef const DS3DLISTENER *LPCDS3DLISTENER;
399 
400 typedef struct _DSCCAPS
401 {
402     DWORD           dwSize;
403     DWORD           dwFlags;
404     DWORD           dwFormats;
405     DWORD           dwChannels;
406 } DSCCAPS, *LPDSCCAPS;
407 
408 typedef const DSCCAPS *LPCDSCCAPS;
409 
410 typedef struct _DSCBUFFERDESC1
411 {
412     DWORD           dwSize;
413     DWORD           dwFlags;
414     DWORD           dwBufferBytes;
415     DWORD           dwReserved;
416     LPWAVEFORMATEX  lpwfxFormat;
417 } DSCBUFFERDESC1, *LPDSCBUFFERDESC1;
418 
419 typedef struct _DSCBUFFERDESC
420 {
421     DWORD           dwSize;
422     DWORD           dwFlags;
423     DWORD           dwBufferBytes;
424     DWORD           dwReserved;
425     LPWAVEFORMATEX  lpwfxFormat;
426 #if DIRECTSOUND_VERSION >= 0x0800
427     DWORD           dwFXCount;
428     LPDSCEFFECTDESC lpDSCFXDesc;
429 #endif
430 } DSCBUFFERDESC, *LPDSCBUFFERDESC;
431 
432 typedef const DSCBUFFERDESC *LPCDSCBUFFERDESC;
433 
434 typedef struct _DSCBCAPS
435 {
436     DWORD           dwSize;
437     DWORD           dwFlags;
438     DWORD           dwBufferBytes;
439     DWORD           dwReserved;
440 } DSCBCAPS, *LPDSCBCAPS;
441 
442 typedef const DSCBCAPS *LPCDSCBCAPS;
443 
444 typedef struct _DSBPOSITIONNOTIFY
445 {
446     DWORD           dwOffset;
447     HANDLE          hEventNotify;
448 } DSBPOSITIONNOTIFY, *LPDSBPOSITIONNOTIFY;
449 
450 typedef const DSBPOSITIONNOTIFY *LPCDSBPOSITIONNOTIFY;
451 
452 //
453 // DirectSound API
454 //
455 
456 typedef BOOL (CALLBACK *LPDSENUMCALLBACKA)(LPGUID, LPCSTR, LPCSTR, LPVOID);
457 typedef BOOL (CALLBACK *LPDSENUMCALLBACKW)(LPGUID, LPCWSTR, LPCWSTR, LPVOID);
458 
459 extern HRESULT WINAPI DirectSoundCreate(LPCGUID pcGuidDevice, LPDIRECTSOUND *ppDS, LPUNKNOWN pUnkOuter);
460 extern HRESULT WINAPI DirectSoundEnumerateA(LPDSENUMCALLBACKA pDSEnumCallback, LPVOID pContext);
461 extern HRESULT WINAPI DirectSoundEnumerateW(LPDSENUMCALLBACKW pDSEnumCallback, LPVOID pContext);
462 
463 extern HRESULT WINAPI DirectSoundCaptureCreate(LPCGUID pcGuidDevice, LPDIRECTSOUNDCAPTURE *ppDSC, LPUNKNOWN pUnkOuter);
464 extern HRESULT WINAPI DirectSoundCaptureEnumerateA(LPDSENUMCALLBACKA pDSEnumCallback, LPVOID pContext);
465 extern HRESULT WINAPI DirectSoundCaptureEnumerateW(LPDSENUMCALLBACKW pDSEnumCallback, LPVOID pContext);
466 
467 #if DIRECTSOUND_VERSION >= 0x0800
468 extern HRESULT WINAPI DirectSoundCreate8(LPCGUID pcGuidDevice, LPDIRECTSOUND8 *ppDS8, LPUNKNOWN pUnkOuter);
469 extern HRESULT WINAPI DirectSoundCaptureCreate8(LPCGUID pcGuidDevice, LPDIRECTSOUNDCAPTURE8 *ppDSC8, LPUNKNOWN pUnkOuter);
470 extern HRESULT WINAPI DirectSoundFullDuplexCreate(LPCGUID pcGuidCaptureDevice, LPCGUID pcGuidRenderDevice,
471         LPCDSCBUFFERDESC pcDSCBufferDesc, LPCDSBUFFERDESC pcDSBufferDesc, HWND hWnd,
472         DWORD dwLevel, LPDIRECTSOUNDFULLDUPLEX* ppDSFD, LPDIRECTSOUNDCAPTUREBUFFER8 *ppDSCBuffer8,
473         LPDIRECTSOUNDBUFFER8 *ppDSBuffer8, LPUNKNOWN pUnkOuter);
474 #define DirectSoundFullDuplexCreate8 DirectSoundFullDuplexCreate
475 
476 extern HRESULT WINAPI GetDeviceID(LPCGUID pGuidSrc, LPGUID pGuidDest);
477 #endif // DIRECTSOUND_VERSION >= 0x0800
478 
479 #ifdef UNICODE
480 #define LPDSENUMCALLBACK            LPDSENUMCALLBACKW
481 #define DirectSoundEnumerate        DirectSoundEnumerateW
482 #define DirectSoundCaptureEnumerate DirectSoundCaptureEnumerateW
483 #else // UNICODE
484 #define LPDSENUMCALLBACK            LPDSENUMCALLBACKA
485 #define DirectSoundEnumerate        DirectSoundEnumerateA
486 #define DirectSoundCaptureEnumerate DirectSoundCaptureEnumerateA
487 #endif // UNICODE
488 
489 //
490 // IUnknown
491 //
492 
493 #if !defined(__cplusplus) || defined(CINTERFACE)
494 #ifndef IUnknown_QueryInterface
495 #define IUnknown_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
496 #endif // IUnknown_QueryInterface
497 #ifndef IUnknown_AddRef
498 #define IUnknown_AddRef(p)              (p)->lpVtbl->AddRef(p)
499 #endif // IUnknown_AddRef
500 #ifndef IUnknown_Release
501 #define IUnknown_Release(p)             (p)->lpVtbl->Release(p)
502 #endif // IUnknown_Release
503 #else // !defined(__cplusplus) || defined(CINTERFACE)
504 #ifndef IUnknown_QueryInterface
505 #define IUnknown_QueryInterface(p,a,b)  (p)->QueryInterface(a,b)
506 #endif // IUnknown_QueryInterface
507 #ifndef IUnknown_AddRef
508 #define IUnknown_AddRef(p)              (p)->AddRef()
509 #endif // IUnknown_AddRef
510 #ifndef IUnknown_Release
511 #define IUnknown_Release(p)             (p)->Release()
512 #endif // IUnknown_Release
513 #endif // !defined(__cplusplus) || defined(CINTERFACE)
514 
515 #ifndef __IReferenceClock_INTERFACE_DEFINED__
516 #define __IReferenceClock_INTERFACE_DEFINED__
517 
518 typedef LONGLONG REFERENCE_TIME;
519 typedef REFERENCE_TIME *LPREFERENCE_TIME;
520 
521 DEFINE_GUID(IID_IReferenceClock, 0x56a86897, 0x0ad4, 0x11ce, 0xb0, 0x3a, 0x00, 0x20, 0xaf, 0x0b, 0xa7, 0x70);
522 
523 #undef INTERFACE
524 #define INTERFACE IReferenceClock
525 
DECLARE_INTERFACE_(IReferenceClock,IUnknown)526 DECLARE_INTERFACE_(IReferenceClock, IUnknown)
527 {
528     // IUnknown methods
529     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
530     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
531     STDMETHOD_(ULONG,Release)       (THIS) PURE;
532 
533     // IReferenceClock methods
534     STDMETHOD(GetTime)              (THIS_ REFERENCE_TIME *pTime) PURE;
535     STDMETHOD(AdviseTime)           (THIS_ REFERENCE_TIME rtBaseTime, REFERENCE_TIME rtStreamTime,
536                                            HANDLE hEvent, LPDWORD pdwAdviseCookie) PURE;
537     STDMETHOD(AdvisePeriodic)       (THIS_ REFERENCE_TIME rtStartTime, REFERENCE_TIME rtPeriodTime,
538                                            HANDLE hSemaphore, LPDWORD pdwAdviseCookie) PURE;
539     STDMETHOD(Unadvise)             (THIS_ DWORD dwAdviseCookie) PURE;
540 };
541 
542 #endif // __IReferenceClock_INTERFACE_DEFINED__
543 
544 #ifndef IReferenceClock_QueryInterface
545 
546 #define IReferenceClock_QueryInterface(p,a,b)      IUnknown_QueryInterface(p,a,b)
547 #define IReferenceClock_AddRef(p)                  IUnknown_AddRef(p)
548 #define IReferenceClock_Release(p)                 IUnknown_Release(p)
549 
550 #if !defined(__cplusplus) || defined(CINTERFACE)
551 #define IReferenceClock_GetTime(p,a)               (p)->lpVtbl->GetTime(p,a)
552 #define IReferenceClock_AdviseTime(p,a,b,c,d)      (p)->lpVtbl->AdviseTime(p,a,b,c,d)
553 #define IReferenceClock_AdvisePeriodic(p,a,b,c,d)  (p)->lpVtbl->AdvisePeriodic(p,a,b,c,d)
554 #define IReferenceClock_Unadvise(p,a)              (p)->lpVtbl->Unadvise(p,a)
555 #else // !defined(__cplusplus) || defined(CINTERFACE)
556 #define IReferenceClock_GetTime(p,a)               (p)->GetTime(a)
557 #define IReferenceClock_AdviseTime(p,a,b,c,d)      (p)->AdviseTime(a,b,c,d)
558 #define IReferenceClock_AdvisePeriodic(p,a,b,c,d)  (p)->AdvisePeriodic(a,b,c,d)
559 #define IReferenceClock_Unadvise(p,a)              (p)->Unadvise(a)
560 #endif // !defined(__cplusplus) || defined(CINTERFACE)
561 
562 #endif // IReferenceClock_QueryInterface
563 
564 //
565 // IDirectSound
566 //
567 
568 DEFINE_GUID(IID_IDirectSound, 0x279AFA83, 0x4981, 0x11CE, 0xA5, 0x21, 0x00, 0x20, 0xAF, 0x0B, 0xE5, 0x60);
569 
570 #undef INTERFACE
571 #define INTERFACE IDirectSound
572 
DECLARE_INTERFACE_(IDirectSound,IUnknown)573 DECLARE_INTERFACE_(IDirectSound, IUnknown)
574 {
575     // IUnknown methods
576     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
577     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
578     STDMETHOD_(ULONG,Release)       (THIS) PURE;
579 
580     // IDirectSound methods
581     STDMETHOD(CreateSoundBuffer)    (THIS_ LPCDSBUFFERDESC pcDSBufferDesc, LPDIRECTSOUNDBUFFER *ppDSBuffer, LPUNKNOWN pUnkOuter) PURE;
582     STDMETHOD(GetCaps)              (THIS_ LPDSCAPS pDSCaps) PURE;
583     STDMETHOD(DuplicateSoundBuffer) (THIS_ LPDIRECTSOUNDBUFFER pDSBufferOriginal, LPDIRECTSOUNDBUFFER *ppDSBufferDuplicate) PURE;
584     STDMETHOD(SetCooperativeLevel)  (THIS_ HWND hwnd, DWORD dwLevel) PURE;
585     STDMETHOD(Compact)              (THIS) PURE;
586     STDMETHOD(GetSpeakerConfig)     (THIS_ LPDWORD pdwSpeakerConfig) PURE;
587     STDMETHOD(SetSpeakerConfig)     (THIS_ DWORD dwSpeakerConfig) PURE;
588     STDMETHOD(Initialize)           (THIS_ LPCGUID pcGuidDevice) PURE;
589 };
590 
591 #define IDirectSound_QueryInterface(p,a,b)       IUnknown_QueryInterface(p,a,b)
592 #define IDirectSound_AddRef(p)                   IUnknown_AddRef(p)
593 #define IDirectSound_Release(p)                  IUnknown_Release(p)
594 
595 #if !defined(__cplusplus) || defined(CINTERFACE)
596 #define IDirectSound_CreateSoundBuffer(p,a,b,c)  (p)->lpVtbl->CreateSoundBuffer(p,a,b,c)
597 #define IDirectSound_GetCaps(p,a)                (p)->lpVtbl->GetCaps(p,a)
598 #define IDirectSound_DuplicateSoundBuffer(p,a,b) (p)->lpVtbl->DuplicateSoundBuffer(p,a,b)
599 #define IDirectSound_SetCooperativeLevel(p,a,b)  (p)->lpVtbl->SetCooperativeLevel(p,a,b)
600 #define IDirectSound_Compact(p)                  (p)->lpVtbl->Compact(p)
601 #define IDirectSound_GetSpeakerConfig(p,a)       (p)->lpVtbl->GetSpeakerConfig(p,a)
602 #define IDirectSound_SetSpeakerConfig(p,b)       (p)->lpVtbl->SetSpeakerConfig(p,b)
603 #define IDirectSound_Initialize(p,a)             (p)->lpVtbl->Initialize(p,a)
604 #else // !defined(__cplusplus) || defined(CINTERFACE)
605 #define IDirectSound_CreateSoundBuffer(p,a,b,c)  (p)->CreateSoundBuffer(a,b,c)
606 #define IDirectSound_GetCaps(p,a)                (p)->GetCaps(a)
607 #define IDirectSound_DuplicateSoundBuffer(p,a,b) (p)->DuplicateSoundBuffer(a,b)
608 #define IDirectSound_SetCooperativeLevel(p,a,b)  (p)->SetCooperativeLevel(a,b)
609 #define IDirectSound_Compact(p)                  (p)->Compact()
610 #define IDirectSound_GetSpeakerConfig(p,a)       (p)->GetSpeakerConfig(a)
611 #define IDirectSound_SetSpeakerConfig(p,b)       (p)->SetSpeakerConfig(b)
612 #define IDirectSound_Initialize(p,a)             (p)->Initialize(a)
613 #endif // !defined(__cplusplus) || defined(CINTERFACE)
614 
615 #if DIRECTSOUND_VERSION >= 0x0800
616 
617 //
618 // IDirectSound8
619 //
620 
621 DEFINE_GUID(IID_IDirectSound8, 0xC50A7E93, 0xF395, 0x4834, 0x9E, 0xF6, 0x7F, 0xA9, 0x9D, 0xE5, 0x09, 0x66);
622 
623 #undef INTERFACE
624 #define INTERFACE IDirectSound8
625 
DECLARE_INTERFACE_(IDirectSound8,IDirectSound)626 DECLARE_INTERFACE_(IDirectSound8, IDirectSound)
627 {
628     // IUnknown methods
629     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
630     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
631     STDMETHOD_(ULONG,Release)       (THIS) PURE;
632 
633     // IDirectSound methods
634     STDMETHOD(CreateSoundBuffer)    (THIS_ LPCDSBUFFERDESC pcDSBufferDesc, LPDIRECTSOUNDBUFFER *ppDSBuffer, LPUNKNOWN pUnkOuter) PURE;
635     STDMETHOD(GetCaps)              (THIS_ LPDSCAPS pDSCaps) PURE;
636     STDMETHOD(DuplicateSoundBuffer) (THIS_ LPDIRECTSOUNDBUFFER pDSBufferOriginal, LPDIRECTSOUNDBUFFER *ppDSBufferDuplicate) PURE;
637     STDMETHOD(SetCooperativeLevel)  (THIS_ HWND hwnd, DWORD dwLevel) PURE;
638     STDMETHOD(Compact)              (THIS) PURE;
639     STDMETHOD(GetSpeakerConfig)     (THIS_ LPDWORD pdwSpeakerConfig) PURE;
640     STDMETHOD(SetSpeakerConfig)     (THIS_ DWORD dwSpeakerConfig) PURE;
641     STDMETHOD(Initialize)           (THIS_ LPCGUID pcGuidDevice) PURE;
642 
643     // IDirectSound8 methods
644     STDMETHOD(VerifyCertification)  (THIS_ LPDWORD pdwCertified) PURE;
645 };
646 
647 #define IDirectSound8_QueryInterface(p,a,b)       IDirectSound_QueryInterface(p,a,b)
648 #define IDirectSound8_AddRef(p)                   IDirectSound_AddRef(p)
649 #define IDirectSound8_Release(p)                  IDirectSound_Release(p)
650 #define IDirectSound8_CreateSoundBuffer(p,a,b,c)  IDirectSound_CreateSoundBuffer(p,a,b,c)
651 #define IDirectSound8_GetCaps(p,a)                IDirectSound_GetCaps(p,a)
652 #define IDirectSound8_DuplicateSoundBuffer(p,a,b) IDirectSound_DuplicateSoundBuffer(p,a,b)
653 #define IDirectSound8_SetCooperativeLevel(p,a,b)  IDirectSound_SetCooperativeLevel(p,a,b)
654 #define IDirectSound8_Compact(p)                  IDirectSound_Compact(p)
655 #define IDirectSound8_GetSpeakerConfig(p,a)       IDirectSound_GetSpeakerConfig(p,a)
656 #define IDirectSound8_SetSpeakerConfig(p,a)       IDirectSound_SetSpeakerConfig(p,a)
657 #define IDirectSound8_Initialize(p,a)             IDirectSound_Initialize(p,a)
658 
659 #if !defined(__cplusplus) || defined(CINTERFACE)
660 #define IDirectSound8_VerifyCertification(p,a)           (p)->lpVtbl->VerifyCertification(p,a)
661 #else // !defined(__cplusplus) || defined(CINTERFACE)
662 #define IDirectSound8_VerifyCertification(p,a)           (p)->VerifyCertification(a)
663 #endif // !defined(__cplusplus) || defined(CINTERFACE)
664 
665 #endif // DIRECTSOUND_VERSION >= 0x0800
666 
667 //
668 // IDirectSoundBuffer
669 //
670 
671 DEFINE_GUID(IID_IDirectSoundBuffer, 0x279AFA85, 0x4981, 0x11CE, 0xA5, 0x21, 0x00, 0x20, 0xAF, 0x0B, 0xE5, 0x60);
672 
673 #undef INTERFACE
674 #define INTERFACE IDirectSoundBuffer
675 
DECLARE_INTERFACE_(IDirectSoundBuffer,IUnknown)676 DECLARE_INTERFACE_(IDirectSoundBuffer, IUnknown)
677 {
678     // IUnknown methods
679     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
680     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
681     STDMETHOD_(ULONG,Release)       (THIS) PURE;
682 
683     // IDirectSoundBuffer methods
684     STDMETHOD(GetCaps)              (THIS_ LPDSBCAPS pDSBufferCaps) PURE;
685     STDMETHOD(GetCurrentPosition)   (THIS_ LPDWORD pdwCurrentPlayCursor, LPDWORD pdwCurrentWriteCursor) PURE;
686     STDMETHOD(GetFormat)            (THIS_ LPWAVEFORMATEX pwfxFormat, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten) PURE;
687     STDMETHOD(GetVolume)            (THIS_ LPLONG plVolume) PURE;
688     STDMETHOD(GetPan)               (THIS_ LPLONG plPan) PURE;
689     STDMETHOD(GetFrequency)         (THIS_ LPDWORD pdwFrequency) PURE;
690     STDMETHOD(GetStatus)            (THIS_ LPDWORD pdwStatus) PURE;
691     STDMETHOD(Initialize)           (THIS_ LPDIRECTSOUND pDirectSound, LPCDSBUFFERDESC pcDSBufferDesc) PURE;
692     STDMETHOD(Lock)                 (THIS_ DWORD dwOffset, DWORD dwBytes, LPVOID *ppvAudioPtr1, LPDWORD pdwAudioBytes1,
693                                            LPVOID *ppvAudioPtr2, LPDWORD pdwAudioBytes2, DWORD dwFlags) PURE;
694     STDMETHOD(Play)                 (THIS_ DWORD dwReserved1, DWORD dwPriority, DWORD dwFlags) PURE;
695     STDMETHOD(SetCurrentPosition)   (THIS_ DWORD dwNewPosition) PURE;
696     STDMETHOD(SetFormat)            (THIS_ LPCWAVEFORMATEX pcfxFormat) PURE;
697     STDMETHOD(SetVolume)            (THIS_ LONG lVolume) PURE;
698     STDMETHOD(SetPan)               (THIS_ LONG lPan) PURE;
699     STDMETHOD(SetFrequency)         (THIS_ DWORD dwFrequency) PURE;
700     STDMETHOD(Stop)                 (THIS) PURE;
701     STDMETHOD(Unlock)               (THIS_ LPVOID pvAudioPtr1, DWORD dwAudioBytes1, LPVOID pvAudioPtr2, DWORD dwAudioBytes2) PURE;
702     STDMETHOD(Restore)              (THIS) PURE;
703 };
704 
705 #define IDirectSoundBuffer_QueryInterface(p,a,b)        IUnknown_QueryInterface(p,a,b)
706 #define IDirectSoundBuffer_AddRef(p)                    IUnknown_AddRef(p)
707 #define IDirectSoundBuffer_Release(p)                   IUnknown_Release(p)
708 
709 #if !defined(__cplusplus) || defined(CINTERFACE)
710 #define IDirectSoundBuffer_GetCaps(p,a)                 (p)->lpVtbl->GetCaps(p,a)
711 #define IDirectSoundBuffer_GetCurrentPosition(p,a,b)    (p)->lpVtbl->GetCurrentPosition(p,a,b)
712 #define IDirectSoundBuffer_GetFormat(p,a,b,c)           (p)->lpVtbl->GetFormat(p,a,b,c)
713 #define IDirectSoundBuffer_GetVolume(p,a)               (p)->lpVtbl->GetVolume(p,a)
714 #define IDirectSoundBuffer_GetPan(p,a)                  (p)->lpVtbl->GetPan(p,a)
715 #define IDirectSoundBuffer_GetFrequency(p,a)            (p)->lpVtbl->GetFrequency(p,a)
716 #define IDirectSoundBuffer_GetStatus(p,a)               (p)->lpVtbl->GetStatus(p,a)
717 #define IDirectSoundBuffer_Initialize(p,a,b)            (p)->lpVtbl->Initialize(p,a,b)
718 #define IDirectSoundBuffer_Lock(p,a,b,c,d,e,f,g)        (p)->lpVtbl->Lock(p,a,b,c,d,e,f,g)
719 #define IDirectSoundBuffer_Play(p,a,b,c)                (p)->lpVtbl->Play(p,a,b,c)
720 #define IDirectSoundBuffer_SetCurrentPosition(p,a)      (p)->lpVtbl->SetCurrentPosition(p,a)
721 #define IDirectSoundBuffer_SetFormat(p,a)               (p)->lpVtbl->SetFormat(p,a)
722 #define IDirectSoundBuffer_SetVolume(p,a)               (p)->lpVtbl->SetVolume(p,a)
723 #define IDirectSoundBuffer_SetPan(p,a)                  (p)->lpVtbl->SetPan(p,a)
724 #define IDirectSoundBuffer_SetFrequency(p,a)            (p)->lpVtbl->SetFrequency(p,a)
725 #define IDirectSoundBuffer_Stop(p)                      (p)->lpVtbl->Stop(p)
726 #define IDirectSoundBuffer_Unlock(p,a,b,c,d)            (p)->lpVtbl->Unlock(p,a,b,c,d)
727 #define IDirectSoundBuffer_Restore(p)                   (p)->lpVtbl->Restore(p)
728 #else // !defined(__cplusplus) || defined(CINTERFACE)
729 #define IDirectSoundBuffer_GetCaps(p,a)                 (p)->GetCaps(a)
730 #define IDirectSoundBuffer_GetCurrentPosition(p,a,b)    (p)->GetCurrentPosition(a,b)
731 #define IDirectSoundBuffer_GetFormat(p,a,b,c)           (p)->GetFormat(a,b,c)
732 #define IDirectSoundBuffer_GetVolume(p,a)               (p)->GetVolume(a)
733 #define IDirectSoundBuffer_GetPan(p,a)                  (p)->GetPan(a)
734 #define IDirectSoundBuffer_GetFrequency(p,a)            (p)->GetFrequency(a)
735 #define IDirectSoundBuffer_GetStatus(p,a)               (p)->GetStatus(a)
736 #define IDirectSoundBuffer_Initialize(p,a,b)            (p)->Initialize(a,b)
737 #define IDirectSoundBuffer_Lock(p,a,b,c,d,e,f,g)        (p)->Lock(a,b,c,d,e,f,g)
738 #define IDirectSoundBuffer_Play(p,a,b,c)                (p)->Play(a,b,c)
739 #define IDirectSoundBuffer_SetCurrentPosition(p,a)      (p)->SetCurrentPosition(a)
740 #define IDirectSoundBuffer_SetFormat(p,a)               (p)->SetFormat(a)
741 #define IDirectSoundBuffer_SetVolume(p,a)               (p)->SetVolume(a)
742 #define IDirectSoundBuffer_SetPan(p,a)                  (p)->SetPan(a)
743 #define IDirectSoundBuffer_SetFrequency(p,a)            (p)->SetFrequency(a)
744 #define IDirectSoundBuffer_Stop(p)                      (p)->Stop()
745 #define IDirectSoundBuffer_Unlock(p,a,b,c,d)            (p)->Unlock(a,b,c,d)
746 #define IDirectSoundBuffer_Restore(p)                   (p)->Restore()
747 #endif // !defined(__cplusplus) || defined(CINTERFACE)
748 
749 #if DIRECTSOUND_VERSION >= 0x0800
750 
751 //
752 // IDirectSoundBuffer8
753 //
754 
755 DEFINE_GUID(IID_IDirectSoundBuffer8, 0x6825a449, 0x7524, 0x4d82, 0x92, 0x0f, 0x50, 0xe3, 0x6a, 0xb3, 0xab, 0x1e);
756 
757 #undef INTERFACE
758 #define INTERFACE IDirectSoundBuffer8
759 
DECLARE_INTERFACE_(IDirectSoundBuffer8,IDirectSoundBuffer)760 DECLARE_INTERFACE_(IDirectSoundBuffer8, IDirectSoundBuffer)
761 {
762     // IUnknown methods
763     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
764     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
765     STDMETHOD_(ULONG,Release)       (THIS) PURE;
766 
767     // IDirectSoundBuffer methods
768     STDMETHOD(GetCaps)              (THIS_ LPDSBCAPS pDSBufferCaps) PURE;
769     STDMETHOD(GetCurrentPosition)   (THIS_ LPDWORD pdwCurrentPlayCursor, LPDWORD pdwCurrentWriteCursor) PURE;
770     STDMETHOD(GetFormat)            (THIS_ LPWAVEFORMATEX pwfxFormat, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten) PURE;
771     STDMETHOD(GetVolume)            (THIS_ LPLONG plVolume) PURE;
772     STDMETHOD(GetPan)               (THIS_ LPLONG plPan) PURE;
773     STDMETHOD(GetFrequency)         (THIS_ LPDWORD pdwFrequency) PURE;
774     STDMETHOD(GetStatus)            (THIS_ LPDWORD pdwStatus) PURE;
775     STDMETHOD(Initialize)           (THIS_ LPDIRECTSOUND pDirectSound, LPCDSBUFFERDESC pcDSBufferDesc) PURE;
776     STDMETHOD(Lock)                 (THIS_ DWORD dwOffset, DWORD dwBytes, LPVOID *ppvAudioPtr1, LPDWORD pdwAudioBytes1,
777                                            LPVOID *ppvAudioPtr2, LPDWORD pdwAudioBytes2, DWORD dwFlags) PURE;
778     STDMETHOD(Play)                 (THIS_ DWORD dwReserved1, DWORD dwPriority, DWORD dwFlags) PURE;
779     STDMETHOD(SetCurrentPosition)   (THIS_ DWORD dwNewPosition) PURE;
780     STDMETHOD(SetFormat)            (THIS_ LPCWAVEFORMATEX pcfxFormat) PURE;
781     STDMETHOD(SetVolume)            (THIS_ LONG lVolume) PURE;
782     STDMETHOD(SetPan)               (THIS_ LONG lPan) PURE;
783     STDMETHOD(SetFrequency)         (THIS_ DWORD dwFrequency) PURE;
784     STDMETHOD(Stop)                 (THIS) PURE;
785     STDMETHOD(Unlock)               (THIS_ LPVOID pvAudioPtr1, DWORD dwAudioBytes1, LPVOID pvAudioPtr2, DWORD dwAudioBytes2) PURE;
786     STDMETHOD(Restore)              (THIS) PURE;
787 
788     // IDirectSoundBuffer8 methods
789     STDMETHOD(SetFX)                (THIS_ DWORD dwEffectsCount, LPDSEFFECTDESC pDSFXDesc, LPDWORD pdwResultCodes) PURE;
790     STDMETHOD(AcquireResources)     (THIS_ DWORD dwFlags, DWORD dwEffectsCount, LPDWORD pdwResultCodes) PURE;
791     STDMETHOD(GetObjectInPath)      (THIS_ REFGUID rguidObject, DWORD dwIndex, REFGUID rguidInterface, LPVOID *ppObject) PURE;
792 };
793 
794 // Special GUID meaning "select all objects" for use in GetObjectInPath()
795 DEFINE_GUID(GUID_All_Objects, 0xaa114de5, 0xc262, 0x4169, 0xa1, 0xc8, 0x23, 0xd6, 0x98, 0xcc, 0x73, 0xb5);
796 
797 #define IDirectSoundBuffer8_QueryInterface(p,a,b)           IUnknown_QueryInterface(p,a,b)
798 #define IDirectSoundBuffer8_AddRef(p)                       IUnknown_AddRef(p)
799 #define IDirectSoundBuffer8_Release(p)                      IUnknown_Release(p)
800 
801 #define IDirectSoundBuffer8_GetCaps(p,a)                    IDirectSoundBuffer_GetCaps(p,a)
802 #define IDirectSoundBuffer8_GetCurrentPosition(p,a,b)       IDirectSoundBuffer_GetCurrentPosition(p,a,b)
803 #define IDirectSoundBuffer8_GetFormat(p,a,b,c)              IDirectSoundBuffer_GetFormat(p,a,b,c)
804 #define IDirectSoundBuffer8_GetVolume(p,a)                  IDirectSoundBuffer_GetVolume(p,a)
805 #define IDirectSoundBuffer8_GetPan(p,a)                     IDirectSoundBuffer_GetPan(p,a)
806 #define IDirectSoundBuffer8_GetFrequency(p,a)               IDirectSoundBuffer_GetFrequency(p,a)
807 #define IDirectSoundBuffer8_GetStatus(p,a)                  IDirectSoundBuffer_GetStatus(p,a)
808 #define IDirectSoundBuffer8_Initialize(p,a,b)               IDirectSoundBuffer_Initialize(p,a,b)
809 #define IDirectSoundBuffer8_Lock(p,a,b,c,d,e,f,g)           IDirectSoundBuffer_Lock(p,a,b,c,d,e,f,g)
810 #define IDirectSoundBuffer8_Play(p,a,b,c)                   IDirectSoundBuffer_Play(p,a,b,c)
811 #define IDirectSoundBuffer8_SetCurrentPosition(p,a)         IDirectSoundBuffer_SetCurrentPosition(p,a)
812 #define IDirectSoundBuffer8_SetFormat(p,a)                  IDirectSoundBuffer_SetFormat(p,a)
813 #define IDirectSoundBuffer8_SetVolume(p,a)                  IDirectSoundBuffer_SetVolume(p,a)
814 #define IDirectSoundBuffer8_SetPan(p,a)                     IDirectSoundBuffer_SetPan(p,a)
815 #define IDirectSoundBuffer8_SetFrequency(p,a)               IDirectSoundBuffer_SetFrequency(p,a)
816 #define IDirectSoundBuffer8_Stop(p)                         IDirectSoundBuffer_Stop(p)
817 #define IDirectSoundBuffer8_Unlock(p,a,b,c,d)               IDirectSoundBuffer_Unlock(p,a,b,c,d)
818 #define IDirectSoundBuffer8_Restore(p)                      IDirectSoundBuffer_Restore(p)
819 
820 #if !defined(__cplusplus) || defined(CINTERFACE)
821 #define IDirectSoundBuffer8_SetFX(p,a,b,c)                  (p)->lpVtbl->SetFX(p,a,b,c)
822 #define IDirectSoundBuffer8_AcquireResources(p,a,b,c)       (p)->lpVtbl->AcquireResources(p,a,b,c)
823 #define IDirectSoundBuffer8_GetObjectInPath(p,a,b,c,d)      (p)->lpVtbl->GetObjectInPath(p,a,b,c,d)
824 #else // !defined(__cplusplus) || defined(CINTERFACE)
825 #define IDirectSoundBuffer8_SetFX(p,a,b,c)                  (p)->SetFX(a,b,c)
826 #define IDirectSoundBuffer8_AcquireResources(p,a,b,c)       (p)->AcquireResources(a,b,c)
827 #define IDirectSoundBuffer8_GetObjectInPath(p,a,b,c,d)      (p)->GetObjectInPath(a,b,c,d)
828 #endif // !defined(__cplusplus) || defined(CINTERFACE)
829 
830 #endif // DIRECTSOUND_VERSION >= 0x0800
831 
832 //
833 // IDirectSound3DListener
834 //
835 
836 DEFINE_GUID(IID_IDirectSound3DListener, 0x279AFA84, 0x4981, 0x11CE, 0xA5, 0x21, 0x00, 0x20, 0xAF, 0x0B, 0xE5, 0x60);
837 
838 #undef INTERFACE
839 #define INTERFACE IDirectSound3DListener
840 
DECLARE_INTERFACE_(IDirectSound3DListener,IUnknown)841 DECLARE_INTERFACE_(IDirectSound3DListener, IUnknown)
842 {
843     // IUnknown methods
844     STDMETHOD(QueryInterface)           (THIS_ REFIID, LPVOID *) PURE;
845     STDMETHOD_(ULONG,AddRef)            (THIS) PURE;
846     STDMETHOD_(ULONG,Release)           (THIS) PURE;
847 
848     // IDirectSound3DListener methods
849     STDMETHOD(GetAllParameters)         (THIS_ LPDS3DLISTENER pListener) PURE;
850     STDMETHOD(GetDistanceFactor)        (THIS_ D3DVALUE* pflDistanceFactor) PURE;
851     STDMETHOD(GetDopplerFactor)         (THIS_ D3DVALUE* pflDopplerFactor) PURE;
852     STDMETHOD(GetOrientation)           (THIS_ D3DVECTOR* pvOrientFront, D3DVECTOR* pvOrientTop) PURE;
853     STDMETHOD(GetPosition)              (THIS_ D3DVECTOR* pvPosition) PURE;
854     STDMETHOD(GetRolloffFactor)         (THIS_ D3DVALUE* pflRolloffFactor) PURE;
855     STDMETHOD(GetVelocity)              (THIS_ D3DVECTOR* pvVelocity) PURE;
856     STDMETHOD(SetAllParameters)         (THIS_ LPCDS3DLISTENER pcListener, DWORD dwApply) PURE;
857     STDMETHOD(SetDistanceFactor)        (THIS_ D3DVALUE flDistanceFactor, DWORD dwApply) PURE;
858     STDMETHOD(SetDopplerFactor)         (THIS_ D3DVALUE flDopplerFactor, DWORD dwApply) PURE;
859     STDMETHOD(SetOrientation)           (THIS_ D3DVALUE xFront, D3DVALUE yFront, D3DVALUE zFront,
860                                                D3DVALUE xTop, D3DVALUE yTop, D3DVALUE zTop, DWORD dwApply) PURE;
861     STDMETHOD(SetPosition)              (THIS_ D3DVALUE x, D3DVALUE y, D3DVALUE z, DWORD dwApply) PURE;
862     STDMETHOD(SetRolloffFactor)         (THIS_ D3DVALUE flRolloffFactor, DWORD dwApply) PURE;
863     STDMETHOD(SetVelocity)              (THIS_ D3DVALUE x, D3DVALUE y, D3DVALUE z, DWORD dwApply) PURE;
864     STDMETHOD(CommitDeferredSettings)   (THIS) PURE;
865 };
866 
867 #define IDirectSound3DListener_QueryInterface(p,a,b)            IUnknown_QueryInterface(p,a,b)
868 #define IDirectSound3DListener_AddRef(p)                        IUnknown_AddRef(p)
869 #define IDirectSound3DListener_Release(p)                       IUnknown_Release(p)
870 
871 #if !defined(__cplusplus) || defined(CINTERFACE)
872 #define IDirectSound3DListener_GetAllParameters(p,a)            (p)->lpVtbl->GetAllParameters(p,a)
873 #define IDirectSound3DListener_GetDistanceFactor(p,a)           (p)->lpVtbl->GetDistanceFactor(p,a)
874 #define IDirectSound3DListener_GetDopplerFactor(p,a)            (p)->lpVtbl->GetDopplerFactor(p,a)
875 #define IDirectSound3DListener_GetOrientation(p,a,b)            (p)->lpVtbl->GetOrientation(p,a,b)
876 #define IDirectSound3DListener_GetPosition(p,a)                 (p)->lpVtbl->GetPosition(p,a)
877 #define IDirectSound3DListener_GetRolloffFactor(p,a)            (p)->lpVtbl->GetRolloffFactor(p,a)
878 #define IDirectSound3DListener_GetVelocity(p,a)                 (p)->lpVtbl->GetVelocity(p,a)
879 #define IDirectSound3DListener_SetAllParameters(p,a,b)          (p)->lpVtbl->SetAllParameters(p,a,b)
880 #define IDirectSound3DListener_SetDistanceFactor(p,a,b)         (p)->lpVtbl->SetDistanceFactor(p,a,b)
881 #define IDirectSound3DListener_SetDopplerFactor(p,a,b)          (p)->lpVtbl->SetDopplerFactor(p,a,b)
882 #define IDirectSound3DListener_SetOrientation(p,a,b,c,d,e,f,g)  (p)->lpVtbl->SetOrientation(p,a,b,c,d,e,f,g)
883 #define IDirectSound3DListener_SetPosition(p,a,b,c,d)           (p)->lpVtbl->SetPosition(p,a,b,c,d)
884 #define IDirectSound3DListener_SetRolloffFactor(p,a,b)          (p)->lpVtbl->SetRolloffFactor(p,a,b)
885 #define IDirectSound3DListener_SetVelocity(p,a,b,c,d)           (p)->lpVtbl->SetVelocity(p,a,b,c,d)
886 #define IDirectSound3DListener_CommitDeferredSettings(p)        (p)->lpVtbl->CommitDeferredSettings(p)
887 #else // !defined(__cplusplus) || defined(CINTERFACE)
888 #define IDirectSound3DListener_GetAllParameters(p,a)            (p)->GetAllParameters(a)
889 #define IDirectSound3DListener_GetDistanceFactor(p,a)           (p)->GetDistanceFactor(a)
890 #define IDirectSound3DListener_GetDopplerFactor(p,a)            (p)->GetDopplerFactor(a)
891 #define IDirectSound3DListener_GetOrientation(p,a,b)            (p)->GetOrientation(a,b)
892 #define IDirectSound3DListener_GetPosition(p,a)                 (p)->GetPosition(a)
893 #define IDirectSound3DListener_GetRolloffFactor(p,a)            (p)->GetRolloffFactor(a)
894 #define IDirectSound3DListener_GetVelocity(p,a)                 (p)->GetVelocity(a)
895 #define IDirectSound3DListener_SetAllParameters(p,a,b)          (p)->SetAllParameters(a,b)
896 #define IDirectSound3DListener_SetDistanceFactor(p,a,b)         (p)->SetDistanceFactor(a,b)
897 #define IDirectSound3DListener_SetDopplerFactor(p,a,b)          (p)->SetDopplerFactor(a,b)
898 #define IDirectSound3DListener_SetOrientation(p,a,b,c,d,e,f,g)  (p)->SetOrientation(a,b,c,d,e,f,g)
899 #define IDirectSound3DListener_SetPosition(p,a,b,c,d)           (p)->SetPosition(a,b,c,d)
900 #define IDirectSound3DListener_SetRolloffFactor(p,a,b)          (p)->SetRolloffFactor(a,b)
901 #define IDirectSound3DListener_SetVelocity(p,a,b,c,d)           (p)->SetVelocity(a,b,c,d)
902 #define IDirectSound3DListener_CommitDeferredSettings(p)        (p)->CommitDeferredSettings()
903 #endif // !defined(__cplusplus) || defined(CINTERFACE)
904 
905 //
906 // IDirectSound3DBuffer
907 //
908 
909 DEFINE_GUID(IID_IDirectSound3DBuffer, 0x279AFA86, 0x4981, 0x11CE, 0xA5, 0x21, 0x00, 0x20, 0xAF, 0x0B, 0xE5, 0x60);
910 
911 #undef INTERFACE
912 #define INTERFACE IDirectSound3DBuffer
913 
DECLARE_INTERFACE_(IDirectSound3DBuffer,IUnknown)914 DECLARE_INTERFACE_(IDirectSound3DBuffer, IUnknown)
915 {
916     // IUnknown methods
917     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
918     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
919     STDMETHOD_(ULONG,Release)       (THIS) PURE;
920 
921     // IDirectSound3DBuffer methods
922     STDMETHOD(GetAllParameters)     (THIS_ LPDS3DBUFFER pDs3dBuffer) PURE;
923     STDMETHOD(GetConeAngles)        (THIS_ LPDWORD pdwInsideConeAngle, LPDWORD pdwOutsideConeAngle) PURE;
924     STDMETHOD(GetConeOrientation)   (THIS_ D3DVECTOR* pvOrientation) PURE;
925     STDMETHOD(GetConeOutsideVolume) (THIS_ LPLONG plConeOutsideVolume) PURE;
926     STDMETHOD(GetMaxDistance)       (THIS_ D3DVALUE* pflMaxDistance) PURE;
927     STDMETHOD(GetMinDistance)       (THIS_ D3DVALUE* pflMinDistance) PURE;
928     STDMETHOD(GetMode)              (THIS_ LPDWORD pdwMode) PURE;
929     STDMETHOD(GetPosition)          (THIS_ D3DVECTOR* pvPosition) PURE;
930     STDMETHOD(GetVelocity)          (THIS_ D3DVECTOR* pvVelocity) PURE;
931     STDMETHOD(SetAllParameters)     (THIS_ LPCDS3DBUFFER pcDs3dBuffer, DWORD dwApply) PURE;
932     STDMETHOD(SetConeAngles)        (THIS_ DWORD dwInsideConeAngle, DWORD dwOutsideConeAngle, DWORD dwApply) PURE;
933     STDMETHOD(SetConeOrientation)   (THIS_ D3DVALUE x, D3DVALUE y, D3DVALUE z, DWORD dwApply) PURE;
934     STDMETHOD(SetConeOutsideVolume) (THIS_ LONG lConeOutsideVolume, DWORD dwApply) PURE;
935     STDMETHOD(SetMaxDistance)       (THIS_ D3DVALUE flMaxDistance, DWORD dwApply) PURE;
936     STDMETHOD(SetMinDistance)       (THIS_ D3DVALUE flMinDistance, DWORD dwApply) PURE;
937     STDMETHOD(SetMode)              (THIS_ DWORD dwMode, DWORD dwApply) PURE;
938     STDMETHOD(SetPosition)          (THIS_ D3DVALUE x, D3DVALUE y, D3DVALUE z, DWORD dwApply) PURE;
939     STDMETHOD(SetVelocity)          (THIS_ D3DVALUE x, D3DVALUE y, D3DVALUE z, DWORD dwApply) PURE;
940 };
941 
942 #define IDirectSound3DBuffer_QueryInterface(p,a,b)          IUnknown_QueryInterface(p,a,b)
943 #define IDirectSound3DBuffer_AddRef(p)                      IUnknown_AddRef(p)
944 #define IDirectSound3DBuffer_Release(p)                     IUnknown_Release(p)
945 
946 #if !defined(__cplusplus) || defined(CINTERFACE)
947 #define IDirectSound3DBuffer_GetAllParameters(p,a)          (p)->lpVtbl->GetAllParameters(p,a)
948 #define IDirectSound3DBuffer_GetConeAngles(p,a,b)           (p)->lpVtbl->GetConeAngles(p,a,b)
949 #define IDirectSound3DBuffer_GetConeOrientation(p,a)        (p)->lpVtbl->GetConeOrientation(p,a)
950 #define IDirectSound3DBuffer_GetConeOutsideVolume(p,a)      (p)->lpVtbl->GetConeOutsideVolume(p,a)
951 #define IDirectSound3DBuffer_GetPosition(p,a)               (p)->lpVtbl->GetPosition(p,a)
952 #define IDirectSound3DBuffer_GetMinDistance(p,a)            (p)->lpVtbl->GetMinDistance(p,a)
953 #define IDirectSound3DBuffer_GetMaxDistance(p,a)            (p)->lpVtbl->GetMaxDistance(p,a)
954 #define IDirectSound3DBuffer_GetMode(p,a)                   (p)->lpVtbl->GetMode(p,a)
955 #define IDirectSound3DBuffer_GetVelocity(p,a)               (p)->lpVtbl->GetVelocity(p,a)
956 #define IDirectSound3DBuffer_SetAllParameters(p,a,b)        (p)->lpVtbl->SetAllParameters(p,a,b)
957 #define IDirectSound3DBuffer_SetConeAngles(p,a,b,c)         (p)->lpVtbl->SetConeAngles(p,a,b,c)
958 #define IDirectSound3DBuffer_SetConeOrientation(p,a,b,c,d)  (p)->lpVtbl->SetConeOrientation(p,a,b,c,d)
959 #define IDirectSound3DBuffer_SetConeOutsideVolume(p,a,b)    (p)->lpVtbl->SetConeOutsideVolume(p,a,b)
960 #define IDirectSound3DBuffer_SetPosition(p,a,b,c,d)         (p)->lpVtbl->SetPosition(p,a,b,c,d)
961 #define IDirectSound3DBuffer_SetMinDistance(p,a,b)          (p)->lpVtbl->SetMinDistance(p,a,b)
962 #define IDirectSound3DBuffer_SetMaxDistance(p,a,b)          (p)->lpVtbl->SetMaxDistance(p,a,b)
963 #define IDirectSound3DBuffer_SetMode(p,a,b)                 (p)->lpVtbl->SetMode(p,a,b)
964 #define IDirectSound3DBuffer_SetVelocity(p,a,b,c,d)         (p)->lpVtbl->SetVelocity(p,a,b,c,d)
965 #else // !defined(__cplusplus) || defined(CINTERFACE)
966 #define IDirectSound3DBuffer_GetAllParameters(p,a)          (p)->GetAllParameters(a)
967 #define IDirectSound3DBuffer_GetConeAngles(p,a,b)           (p)->GetConeAngles(a,b)
968 #define IDirectSound3DBuffer_GetConeOrientation(p,a)        (p)->GetConeOrientation(a)
969 #define IDirectSound3DBuffer_GetConeOutsideVolume(p,a)      (p)->GetConeOutsideVolume(a)
970 #define IDirectSound3DBuffer_GetPosition(p,a)               (p)->GetPosition(a)
971 #define IDirectSound3DBuffer_GetMinDistance(p,a)            (p)->GetMinDistance(a)
972 #define IDirectSound3DBuffer_GetMaxDistance(p,a)            (p)->GetMaxDistance(a)
973 #define IDirectSound3DBuffer_GetMode(p,a)                   (p)->GetMode(a)
974 #define IDirectSound3DBuffer_GetVelocity(p,a)               (p)->GetVelocity(a)
975 #define IDirectSound3DBuffer_SetAllParameters(p,a,b)        (p)->SetAllParameters(a,b)
976 #define IDirectSound3DBuffer_SetConeAngles(p,a,b,c)         (p)->SetConeAngles(a,b,c)
977 #define IDirectSound3DBuffer_SetConeOrientation(p,a,b,c,d)  (p)->SetConeOrientation(a,b,c,d)
978 #define IDirectSound3DBuffer_SetConeOutsideVolume(p,a,b)    (p)->SetConeOutsideVolume(a,b)
979 #define IDirectSound3DBuffer_SetPosition(p,a,b,c,d)         (p)->SetPosition(a,b,c,d)
980 #define IDirectSound3DBuffer_SetMinDistance(p,a,b)          (p)->SetMinDistance(a,b)
981 #define IDirectSound3DBuffer_SetMaxDistance(p,a,b)          (p)->SetMaxDistance(a,b)
982 #define IDirectSound3DBuffer_SetMode(p,a,b)                 (p)->SetMode(a,b)
983 #define IDirectSound3DBuffer_SetVelocity(p,a,b,c,d)         (p)->SetVelocity(a,b,c,d)
984 #endif // !defined(__cplusplus) || defined(CINTERFACE)
985 
986 //
987 // IDirectSoundCapture
988 //
989 
990 DEFINE_GUID(IID_IDirectSoundCapture, 0xb0210781, 0x89cd, 0x11d0, 0xaf, 0x8, 0x0, 0xa0, 0xc9, 0x25, 0xcd, 0x16);
991 
992 #undef INTERFACE
993 #define INTERFACE IDirectSoundCapture
994 
DECLARE_INTERFACE_(IDirectSoundCapture,IUnknown)995 DECLARE_INTERFACE_(IDirectSoundCapture, IUnknown)
996 {
997     // IUnknown methods
998     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
999     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1000     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1001 
1002     // IDirectSoundCapture methods
1003     STDMETHOD(CreateCaptureBuffer)  (THIS_ LPCDSCBUFFERDESC pcDSCBufferDesc, LPDIRECTSOUNDCAPTUREBUFFER *ppDSCBuffer, LPUNKNOWN pUnkOuter) PURE;
1004     STDMETHOD(GetCaps)              (THIS_ LPDSCCAPS pDSCCaps) PURE;
1005     STDMETHOD(Initialize)           (THIS_ LPCGUID pcGuidDevice) PURE;
1006 };
1007 
1008 #define IDirectSoundCapture_QueryInterface(p,a,b)           IUnknown_QueryInterface(p,a,b)
1009 #define IDirectSoundCapture_AddRef(p)                       IUnknown_AddRef(p)
1010 #define IDirectSoundCapture_Release(p)                      IUnknown_Release(p)
1011 
1012 #if !defined(__cplusplus) || defined(CINTERFACE)
1013 #define IDirectSoundCapture_CreateCaptureBuffer(p,a,b,c)    (p)->lpVtbl->CreateCaptureBuffer(p,a,b,c)
1014 #define IDirectSoundCapture_GetCaps(p,a)                    (p)->lpVtbl->GetCaps(p,a)
1015 #define IDirectSoundCapture_Initialize(p,a)                 (p)->lpVtbl->Initialize(p,a)
1016 #else // !defined(__cplusplus) || defined(CINTERFACE)
1017 #define IDirectSoundCapture_CreateCaptureBuffer(p,a,b,c)    (p)->CreateCaptureBuffer(a,b,c)
1018 #define IDirectSoundCapture_GetCaps(p,a)                    (p)->GetCaps(a)
1019 #define IDirectSoundCapture_Initialize(p,a)                 (p)->Initialize(a)
1020 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1021 
1022 //
1023 // IDirectSoundCaptureBuffer
1024 //
1025 
1026 DEFINE_GUID(IID_IDirectSoundCaptureBuffer, 0xb0210782, 0x89cd, 0x11d0, 0xaf, 0x8, 0x0, 0xa0, 0xc9, 0x25, 0xcd, 0x16);
1027 
1028 #undef INTERFACE
1029 #define INTERFACE IDirectSoundCaptureBuffer
1030 
DECLARE_INTERFACE_(IDirectSoundCaptureBuffer,IUnknown)1031 DECLARE_INTERFACE_(IDirectSoundCaptureBuffer, IUnknown)
1032 {
1033     // IUnknown methods
1034     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1035     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1036     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1037 
1038     // IDirectSoundCaptureBuffer methods
1039     STDMETHOD(GetCaps)              (THIS_ LPDSCBCAPS pDSCBCaps) PURE;
1040     STDMETHOD(GetCurrentPosition)   (THIS_ LPDWORD pdwCapturePosition, LPDWORD pdwReadPosition) PURE;
1041     STDMETHOD(GetFormat)            (THIS_ LPWAVEFORMATEX pwfxFormat, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten) PURE;
1042     STDMETHOD(GetStatus)            (THIS_ LPDWORD pdwStatus) PURE;
1043     STDMETHOD(Initialize)           (THIS_ LPDIRECTSOUNDCAPTURE pDirectSoundCapture, LPCDSCBUFFERDESC pcDSCBufferDesc) PURE;
1044     STDMETHOD(Lock)                 (THIS_ DWORD dwOffset, DWORD dwBytes, LPVOID *ppvAudioPtr1, LPDWORD pdwAudioBytes1,
1045                                            LPVOID *ppvAudioPtr2, LPDWORD pdwAudioBytes2, DWORD dwFlags) PURE;
1046     STDMETHOD(Start)                (THIS_ DWORD dwFlags) PURE;
1047     STDMETHOD(Stop)                 (THIS) PURE;
1048     STDMETHOD(Unlock)               (THIS_ LPVOID pvAudioPtr1, DWORD dwAudioBytes1, LPVOID pvAudioPtr2, DWORD dwAudioBytes2) PURE;
1049 };
1050 
1051 #define IDirectSoundCaptureBuffer_QueryInterface(p,a,b)         IUnknown_QueryInterface(p,a,b)
1052 #define IDirectSoundCaptureBuffer_AddRef(p)                     IUnknown_AddRef(p)
1053 #define IDirectSoundCaptureBuffer_Release(p)                    IUnknown_Release(p)
1054 
1055 #if !defined(__cplusplus) || defined(CINTERFACE)
1056 #define IDirectSoundCaptureBuffer_GetCaps(p,a)                  (p)->lpVtbl->GetCaps(p,a)
1057 #define IDirectSoundCaptureBuffer_GetCurrentPosition(p,a,b)     (p)->lpVtbl->GetCurrentPosition(p,a,b)
1058 #define IDirectSoundCaptureBuffer_GetFormat(p,a,b,c)            (p)->lpVtbl->GetFormat(p,a,b,c)
1059 #define IDirectSoundCaptureBuffer_GetStatus(p,a)                (p)->lpVtbl->GetStatus(p,a)
1060 #define IDirectSoundCaptureBuffer_Initialize(p,a,b)             (p)->lpVtbl->Initialize(p,a,b)
1061 #define IDirectSoundCaptureBuffer_Lock(p,a,b,c,d,e,f,g)         (p)->lpVtbl->Lock(p,a,b,c,d,e,f,g)
1062 #define IDirectSoundCaptureBuffer_Start(p,a)                    (p)->lpVtbl->Start(p,a)
1063 #define IDirectSoundCaptureBuffer_Stop(p)                       (p)->lpVtbl->Stop(p)
1064 #define IDirectSoundCaptureBuffer_Unlock(p,a,b,c,d)             (p)->lpVtbl->Unlock(p,a,b,c,d)
1065 #else // !defined(__cplusplus) || defined(CINTERFACE)
1066 #define IDirectSoundCaptureBuffer_GetCaps(p,a)                  (p)->GetCaps(a)
1067 #define IDirectSoundCaptureBuffer_GetCurrentPosition(p,a,b)     (p)->GetCurrentPosition(a,b)
1068 #define IDirectSoundCaptureBuffer_GetFormat(p,a,b,c)            (p)->GetFormat(a,b,c)
1069 #define IDirectSoundCaptureBuffer_GetStatus(p,a)                (p)->GetStatus(a)
1070 #define IDirectSoundCaptureBuffer_Initialize(p,a,b)             (p)->Initialize(a,b)
1071 #define IDirectSoundCaptureBuffer_Lock(p,a,b,c,d,e,f,g)         (p)->Lock(a,b,c,d,e,f,g)
1072 #define IDirectSoundCaptureBuffer_Start(p,a)                    (p)->Start(a)
1073 #define IDirectSoundCaptureBuffer_Stop(p)                       (p)->Stop()
1074 #define IDirectSoundCaptureBuffer_Unlock(p,a,b,c,d)             (p)->Unlock(a,b,c,d)
1075 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1076 
1077 
1078 #if DIRECTSOUND_VERSION >= 0x0800
1079 
1080 //
1081 // IDirectSoundCaptureBuffer8
1082 //
1083 
1084 DEFINE_GUID(IID_IDirectSoundCaptureBuffer8, 0x990df4, 0xdbb, 0x4872, 0x83, 0x3e, 0x6d, 0x30, 0x3e, 0x80, 0xae, 0xb6);
1085 
1086 #undef INTERFACE
1087 #define INTERFACE IDirectSoundCaptureBuffer8
1088 
DECLARE_INTERFACE_(IDirectSoundCaptureBuffer8,IDirectSoundCaptureBuffer)1089 DECLARE_INTERFACE_(IDirectSoundCaptureBuffer8, IDirectSoundCaptureBuffer)
1090 {
1091     // IUnknown methods
1092     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1093     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1094     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1095 
1096     // IDirectSoundCaptureBuffer methods
1097     STDMETHOD(GetCaps)              (THIS_ LPDSCBCAPS pDSCBCaps) PURE;
1098     STDMETHOD(GetCurrentPosition)   (THIS_ LPDWORD pdwCapturePosition, LPDWORD pdwReadPosition) PURE;
1099     STDMETHOD(GetFormat)            (THIS_ LPWAVEFORMATEX pwfxFormat, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten) PURE;
1100     STDMETHOD(GetStatus)            (THIS_ LPDWORD pdwStatus) PURE;
1101     STDMETHOD(Initialize)           (THIS_ LPDIRECTSOUNDCAPTURE pDirectSoundCapture, LPCDSCBUFFERDESC pcDSCBufferDesc) PURE;
1102     STDMETHOD(Lock)                 (THIS_ DWORD dwOffset, DWORD dwBytes, LPVOID *ppvAudioPtr1, LPDWORD pdwAudioBytes1,
1103                                            LPVOID *ppvAudioPtr2, LPDWORD pdwAudioBytes2, DWORD dwFlags) PURE;
1104     STDMETHOD(Start)                (THIS_ DWORD dwFlags) PURE;
1105     STDMETHOD(Stop)                 (THIS) PURE;
1106     STDMETHOD(Unlock)               (THIS_ LPVOID pvAudioPtr1, DWORD dwAudioBytes1, LPVOID pvAudioPtr2, DWORD dwAudioBytes2) PURE;
1107 
1108     // IDirectSoundCaptureBuffer8 methods
1109     STDMETHOD(GetObjectInPath)      (THIS_ REFGUID rguidObject, DWORD dwIndex, REFGUID rguidInterface, LPVOID *ppObject) PURE;
1110     STDMETHOD(GetFXStatus)          (DWORD dwFXCount, LPDWORD pdwFXStatus) PURE;
1111 };
1112 
1113 #define IDirectSoundCaptureBuffer8_QueryInterface(p,a,b)            IUnknown_QueryInterface(p,a,b)
1114 #define IDirectSoundCaptureBuffer8_AddRef(p)                        IUnknown_AddRef(p)
1115 #define IDirectSoundCaptureBuffer8_Release(p)                       IUnknown_Release(p)
1116 
1117 #define IDirectSoundCaptureBuffer8_GetCaps(p,a)                     IDirectSoundCaptureBuffer_GetCaps(p,a)
1118 #define IDirectSoundCaptureBuffer8_GetCurrentPosition(p,a,b)        IDirectSoundCaptureBuffer_GetCurrentPosition(p,a,b)
1119 #define IDirectSoundCaptureBuffer8_GetFormat(p,a,b,c)               IDirectSoundCaptureBuffer_GetFormat(p,a,b,c)
1120 #define IDirectSoundCaptureBuffer8_GetStatus(p,a)                   IDirectSoundCaptureBuffer_GetStatus(p,a)
1121 #define IDirectSoundCaptureBuffer8_Initialize(p,a,b)                IDirectSoundCaptureBuffer_Initialize(p,a,b)
1122 #define IDirectSoundCaptureBuffer8_Lock(p,a,b,c,d,e,f,g)            IDirectSoundCaptureBuffer_Lock(p,a,b,c,d,e,f,g)
1123 #define IDirectSoundCaptureBuffer8_Start(p,a)                       IDirectSoundCaptureBuffer_Start(p,a)
1124 #define IDirectSoundCaptureBuffer8_Stop(p)                          IDirectSoundCaptureBuffer_Stop(p))
1125 #define IDirectSoundCaptureBuffer8_Unlock(p,a,b,c,d)                IDirectSoundCaptureBuffer_Unlock(p,a,b,c,d)
1126 
1127 #if !defined(__cplusplus) || defined(CINTERFACE)
1128 #define IDirectSoundCaptureBuffer8_GetObjectInPath(p,a,b,c,d)       (p)->lpVtbl->GetObjectInPath(p,a,b,c,d)
1129 #define IDirectSoundCaptureBuffer8_GetFXStatus(p,a,b)               (p)->lpVtbl->GetFXStatus(p,a,b)
1130 #else // !defined(__cplusplus) || defined(CINTERFACE)
1131 #define IDirectSoundCaptureBuffer8_GetObjectInPath(p,a,b,c,d)       (p)->GetObjectInPath(a,b,c,d)
1132 #define IDirectSoundCaptureBuffer8_GetFXStatus(p,a,b)               (p)->GetFXStatus(a,b)
1133 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1134 
1135 #endif // DIRECTSOUND_VERSION >= 0x0800
1136 
1137 //
1138 // IDirectSoundNotify
1139 //
1140 
1141 DEFINE_GUID(IID_IDirectSoundNotify, 0xb0210783, 0x89cd, 0x11d0, 0xaf, 0x8, 0x0, 0xa0, 0xc9, 0x25, 0xcd, 0x16);
1142 
1143 #undef INTERFACE
1144 #define INTERFACE IDirectSoundNotify
1145 
DECLARE_INTERFACE_(IDirectSoundNotify,IUnknown)1146 DECLARE_INTERFACE_(IDirectSoundNotify, IUnknown)
1147 {
1148     // IUnknown methods
1149     STDMETHOD(QueryInterface)           (THIS_ REFIID, LPVOID *) PURE;
1150     STDMETHOD_(ULONG,AddRef)            (THIS) PURE;
1151     STDMETHOD_(ULONG,Release)           (THIS) PURE;
1152 
1153     // IDirectSoundNotify methods
1154     STDMETHOD(SetNotificationPositions) (THIS_ DWORD dwPositionNotifies, LPCDSBPOSITIONNOTIFY pcPositionNotifies) PURE;
1155 };
1156 
1157 #define IDirectSoundNotify_QueryInterface(p,a,b)            IUnknown_QueryInterface(p,a,b)
1158 #define IDirectSoundNotify_AddRef(p)                        IUnknown_AddRef(p)
1159 #define IDirectSoundNotify_Release(p)                       IUnknown_Release(p)
1160 
1161 #if !defined(__cplusplus) || defined(CINTERFACE)
1162 #define IDirectSoundNotify_SetNotificationPositions(p,a,b)  (p)->lpVtbl->SetNotificationPositions(p,a,b)
1163 #else // !defined(__cplusplus) || defined(CINTERFACE)
1164 #define IDirectSoundNotify_SetNotificationPositions(p,a,b)  (p)->SetNotificationPositions(a,b)
1165 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1166 
1167 //
1168 // IKsPropertySet
1169 //
1170 
1171 #ifndef _IKsPropertySet_
1172 #define _IKsPropertySet_
1173 
1174 #ifdef __cplusplus
1175 // 'struct' not 'class' per the way DECLARE_INTERFACE_ is defined
1176 struct IKsPropertySet;
1177 #endif // __cplusplus
1178 
1179 typedef struct IKsPropertySet *LPKSPROPERTYSET;
1180 
1181 #define KSPROPERTY_SUPPORT_GET  0x00000001
1182 #define KSPROPERTY_SUPPORT_SET  0x00000002
1183 
1184 DEFINE_GUID(IID_IKsPropertySet, 0x31efac30, 0x515c, 0x11d0, 0xa9, 0xaa, 0x00, 0xaa, 0x00, 0x61, 0xbe, 0x93);
1185 
1186 #undef INTERFACE
1187 #define INTERFACE IKsPropertySet
1188 
DECLARE_INTERFACE_(IKsPropertySet,IUnknown)1189 DECLARE_INTERFACE_(IKsPropertySet, IUnknown)
1190 {
1191     // IUnknown methods
1192     STDMETHOD(QueryInterface)   (THIS_ REFIID, LPVOID *) PURE;
1193     STDMETHOD_(ULONG,AddRef)    (THIS) PURE;
1194     STDMETHOD_(ULONG,Release)   (THIS) PURE;
1195 
1196     // IKsPropertySet methods
1197     STDMETHOD(Get)              (THIS_ REFGUID rguidPropSet, ULONG ulId, LPVOID pInstanceData, ULONG ulInstanceLength,
1198                                        LPVOID pPropertyData, ULONG ulDataLength, PULONG pulBytesReturned) PURE;
1199     STDMETHOD(Set)              (THIS_ REFGUID rguidPropSet, ULONG ulId, LPVOID pInstanceData, ULONG ulInstanceLength,
1200                                        LPVOID pPropertyData, ULONG ulDataLength) PURE;
1201     STDMETHOD(QuerySupport)     (THIS_ REFGUID rguidPropSet, ULONG ulId, PULONG pulTypeSupport) PURE;
1202 };
1203 
1204 #define IKsPropertySet_QueryInterface(p,a,b)       IUnknown_QueryInterface(p,a,b)
1205 #define IKsPropertySet_AddRef(p)                   IUnknown_AddRef(p)
1206 #define IKsPropertySet_Release(p)                  IUnknown_Release(p)
1207 
1208 #if !defined(__cplusplus) || defined(CINTERFACE)
1209 #define IKsPropertySet_Get(p,a,b,c,d,e,f,g)        (p)->lpVtbl->Get(p,a,b,c,d,e,f,g)
1210 #define IKsPropertySet_Set(p,a,b,c,d,e,f)          (p)->lpVtbl->Set(p,a,b,c,d,e,f)
1211 #define IKsPropertySet_QuerySupport(p,a,b,c)       (p)->lpVtbl->QuerySupport(p,a,b,c)
1212 #else // !defined(__cplusplus) || defined(CINTERFACE)
1213 #define IKsPropertySet_Get(p,a,b,c,d,e,f,g)        (p)->Get(a,b,c,d,e,f,g)
1214 #define IKsPropertySet_Set(p,a,b,c,d,e,f)          (p)->Set(a,b,c,d,e,f)
1215 #define IKsPropertySet_QuerySupport(p,a,b,c)       (p)->QuerySupport(a,b,c)
1216 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1217 
1218 #endif // _IKsPropertySet_
1219 
1220 #if DIRECTSOUND_VERSION >= 0x0800
1221 
1222 //
1223 // IDirectSoundFXGargle
1224 //
1225 
1226 DEFINE_GUID(IID_IDirectSoundFXGargle, 0xd616f352, 0xd622, 0x11ce, 0xaa, 0xc5, 0x00, 0x20, 0xaf, 0x0b, 0x99, 0xa3);
1227 
1228 typedef struct _DSFXGargle
1229 {
1230     DWORD       dwRateHz;               // Rate of modulation in hz
1231     DWORD       dwWaveShape;            // DSFXGARGLE_WAVE_xxx
1232 } DSFXGargle, *LPDSFXGargle;
1233 
1234 #define DSFXGARGLE_WAVE_TRIANGLE        0
1235 #define DSFXGARGLE_WAVE_SQUARE          1
1236 
1237 typedef const DSFXGargle *LPCDSFXGargle;
1238 
1239 #define DSFXGARGLE_RATEHZ_MIN           1
1240 #define DSFXGARGLE_RATEHZ_MAX           1000
1241 
1242 #undef INTERFACE
1243 #define INTERFACE IDirectSoundFXGargle
1244 
DECLARE_INTERFACE_(IDirectSoundFXGargle,IUnknown)1245 DECLARE_INTERFACE_(IDirectSoundFXGargle, IUnknown)
1246 {
1247     // IUnknown methods
1248     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1249     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1250     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1251 
1252     // IDirectSoundFXGargle methods
1253     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXGargle pcDsFxGargle) PURE;
1254     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXGargle pDsFxGargle) PURE;
1255 };
1256 
1257 #define IDirectSoundFXGargle_QueryInterface(p,a,b)          IUnknown_QueryInterface(p,a,b)
1258 #define IDirectSoundFXGargle_AddRef(p)                      IUnknown_AddRef(p)
1259 #define IDirectSoundFXGargle_Release(p)                     IUnknown_Release(p)
1260 
1261 #if !defined(__cplusplus) || defined(CINTERFACE)
1262 #define IDirectSoundFXGargle_SetAllParameters(p,a)          (p)->lpVtbl->SetAllParameters(p,a)
1263 #define IDirectSoundFXGargle_GetAllParameters(p,a)          (p)->lpVtbl->GetAllParameters(p,a)
1264 #else // !defined(__cplusplus) || defined(CINTERFACE)
1265 #define IDirectSoundFXGargle_SetAllParameters(p,a)          (p)->SetAllParameters(a)
1266 #define IDirectSoundFXGargle_GetAllParameters(p,a)          (p)->GetAllParameters(a)
1267 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1268 
1269 //
1270 // IDirectSoundFXChorus
1271 //
1272 
1273 DEFINE_GUID(IID_IDirectSoundFXChorus, 0x880842e3, 0x145f, 0x43e6, 0xa9, 0x34, 0xa7, 0x18, 0x06, 0xe5, 0x05, 0x47);
1274 
1275 typedef struct _DSFXChorus
1276 {
1277     FLOAT       fWetDryMix;
1278     FLOAT       fDepth;
1279     FLOAT       fFeedback;
1280     FLOAT       fFrequency;
1281     LONG        lWaveform;          // LFO shape; DSFXCHORUS_WAVE_xxx
1282     FLOAT       fDelay;
1283     LONG        lPhase;
1284 } DSFXChorus, *LPDSFXChorus;
1285 
1286 typedef const DSFXChorus *LPCDSFXChorus;
1287 
1288 #define DSFXCHORUS_WAVE_TRIANGLE        0
1289 #define DSFXCHORUS_WAVE_SIN             1
1290 
1291 #define DSFXCHORUS_WETDRYMIX_MIN        0.0f
1292 #define DSFXCHORUS_WETDRYMIX_MAX        100.0f
1293 #define DSFXCHORUS_DEPTH_MIN            0.0f
1294 #define DSFXCHORUS_DEPTH_MAX            100.0f
1295 #define DSFXCHORUS_FEEDBACK_MIN         -99.0f
1296 #define DSFXCHORUS_FEEDBACK_MAX         99.0f
1297 #define DSFXCHORUS_FREQUENCY_MIN        0.0f
1298 #define DSFXCHORUS_FREQUENCY_MAX        10.0f
1299 #define DSFXCHORUS_DELAY_MIN            0.0f
1300 #define DSFXCHORUS_DELAY_MAX            20.0f
1301 #define DSFXCHORUS_PHASE_MIN            0
1302 #define DSFXCHORUS_PHASE_MAX            4
1303 
1304 #define DSFXCHORUS_PHASE_NEG_180        0
1305 #define DSFXCHORUS_PHASE_NEG_90         1
1306 #define DSFXCHORUS_PHASE_ZERO           2
1307 #define DSFXCHORUS_PHASE_90             3
1308 #define DSFXCHORUS_PHASE_180            4
1309 
1310 #undef INTERFACE
1311 #define INTERFACE IDirectSoundFXChorus
1312 
DECLARE_INTERFACE_(IDirectSoundFXChorus,IUnknown)1313 DECLARE_INTERFACE_(IDirectSoundFXChorus, IUnknown)
1314 {
1315     // IUnknown methods
1316     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1317     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1318     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1319 
1320     // IDirectSoundFXChorus methods
1321     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXChorus pcDsFxChorus) PURE;
1322     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXChorus pDsFxChorus) PURE;
1323 };
1324 
1325 #define IDirectSoundFXChorus_QueryInterface(p,a,b)          IUnknown_QueryInterface(p,a,b)
1326 #define IDirectSoundFXChorus_AddRef(p)                      IUnknown_AddRef(p)
1327 #define IDirectSoundFXChorus_Release(p)                     IUnknown_Release(p)
1328 
1329 #if !defined(__cplusplus) || defined(CINTERFACE)
1330 #define IDirectSoundFXChorus_SetAllParameters(p,a)          (p)->lpVtbl->SetAllParameters(p,a)
1331 #define IDirectSoundFXChorus_GetAllParameters(p,a)          (p)->lpVtbl->GetAllParameters(p,a)
1332 #else // !defined(__cplusplus) || defined(CINTERFACE)
1333 #define IDirectSoundFXChorus_SetAllParameters(p,a)          (p)->SetAllParameters(a)
1334 #define IDirectSoundFXChorus_GetAllParameters(p,a)          (p)->GetAllParameters(a)
1335 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1336 
1337 //
1338 // IDirectSoundFXFlanger
1339 //
1340 
1341 DEFINE_GUID(IID_IDirectSoundFXFlanger, 0x903e9878, 0x2c92, 0x4072, 0x9b, 0x2c, 0xea, 0x68, 0xf5, 0x39, 0x67, 0x83);
1342 
1343 typedef struct _DSFXFlanger
1344 {
1345     FLOAT       fWetDryMix;
1346     FLOAT       fDepth;
1347     FLOAT       fFeedback;
1348     FLOAT       fFrequency;
1349     LONG        lWaveform;
1350     FLOAT       fDelay;
1351     LONG        lPhase;
1352 } DSFXFlanger, *LPDSFXFlanger;
1353 
1354 typedef const DSFXFlanger *LPCDSFXFlanger;
1355 
1356 #define DSFXFLANGER_WAVE_TRIANGLE       0
1357 #define DSFXFLANGER_WAVE_SIN            1
1358 
1359 #define DSFXFLANGER_WETDRYMIX_MIN       0.0f
1360 #define DSFXFLANGER_WETDRYMIX_MAX       100.0f
1361 #define DSFXFLANGER_FREQUENCY_MIN       0.0f
1362 #define DSFXFLANGER_FREQUENCY_MAX       10.0f
1363 #define DSFXFLANGER_DEPTH_MIN           0.0f
1364 #define DSFXFLANGER_DEPTH_MAX           100.0f
1365 #define DSFXFLANGER_PHASE_MIN           0
1366 #define DSFXFLANGER_PHASE_MAX           4
1367 #define DSFXFLANGER_FEEDBACK_MIN        -99.0f
1368 #define DSFXFLANGER_FEEDBACK_MAX        99.0f
1369 #define DSFXFLANGER_DELAY_MIN           0.0f
1370 #define DSFXFLANGER_DELAY_MAX           4.0f
1371 
1372 #define DSFXFLANGER_PHASE_NEG_180       0
1373 #define DSFXFLANGER_PHASE_NEG_90        1
1374 #define DSFXFLANGER_PHASE_ZERO          2
1375 #define DSFXFLANGER_PHASE_90            3
1376 #define DSFXFLANGER_PHASE_180           4
1377 
1378 #undef INTERFACE
1379 #define INTERFACE IDirectSoundFXFlanger
1380 
DECLARE_INTERFACE_(IDirectSoundFXFlanger,IUnknown)1381 DECLARE_INTERFACE_(IDirectSoundFXFlanger, IUnknown)
1382 {
1383     // IUnknown methods
1384     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1385     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1386     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1387 
1388     // IDirectSoundFXFlanger methods
1389     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXFlanger pcDsFxFlanger) PURE;
1390     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXFlanger pDsFxFlanger) PURE;
1391 };
1392 
1393 #define IDirectSoundFXFlanger_QueryInterface(p,a,b)         IUnknown_QueryInterface(p,a,b)
1394 #define IDirectSoundFXFlanger_AddRef(p)                     IUnknown_AddRef(p)
1395 #define IDirectSoundFXFlanger_Release(p)                    IUnknown_Release(p)
1396 
1397 #if !defined(__cplusplus) || defined(CINTERFACE)
1398 #define IDirectSoundFXFlanger_SetAllParameters(p,a)         (p)->lpVtbl->SetAllParameters(p,a)
1399 #define IDirectSoundFXFlanger_GetAllParameters(p,a)         (p)->lpVtbl->GetAllParameters(p,a)
1400 #else // !defined(__cplusplus) || defined(CINTERFACE)
1401 #define IDirectSoundFXFlanger_SetAllParameters(p,a)         (p)->SetAllParameters(a)
1402 #define IDirectSoundFXFlanger_GetAllParameters(p,a)         (p)->GetAllParameters(a)
1403 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1404 
1405 //
1406 // IDirectSoundFXEcho
1407 //
1408 
1409 DEFINE_GUID(IID_IDirectSoundFXEcho, 0x8bd28edf, 0x50db, 0x4e92, 0xa2, 0xbd, 0x44, 0x54, 0x88, 0xd1, 0xed, 0x42);
1410 
1411 typedef struct _DSFXEcho
1412 {
1413     FLOAT   fWetDryMix;
1414     FLOAT   fFeedback;
1415     FLOAT   fLeftDelay;
1416     FLOAT   fRightDelay;
1417     LONG    lPanDelay;
1418 } DSFXEcho, *LPDSFXEcho;
1419 
1420 typedef const DSFXEcho *LPCDSFXEcho;
1421 
1422 #define DSFXECHO_WETDRYMIX_MIN      0.0f
1423 #define DSFXECHO_WETDRYMIX_MAX      100.0f
1424 #define DSFXECHO_FEEDBACK_MIN       0.0f
1425 #define DSFXECHO_FEEDBACK_MAX       100.0f
1426 #define DSFXECHO_LEFTDELAY_MIN      1.0f
1427 #define DSFXECHO_LEFTDELAY_MAX      2000.0f
1428 #define DSFXECHO_RIGHTDELAY_MIN     1.0f
1429 #define DSFXECHO_RIGHTDELAY_MAX     2000.0f
1430 #define DSFXECHO_PANDELAY_MIN       0
1431 #define DSFXECHO_PANDELAY_MAX       1
1432 
1433 #undef INTERFACE
1434 #define INTERFACE IDirectSoundFXEcho
1435 
DECLARE_INTERFACE_(IDirectSoundFXEcho,IUnknown)1436 DECLARE_INTERFACE_(IDirectSoundFXEcho, IUnknown)
1437 {
1438     // IUnknown methods
1439     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1440     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1441     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1442 
1443     // IDirectSoundFXEcho methods
1444     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXEcho pcDsFxEcho) PURE;
1445     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXEcho pDsFxEcho) PURE;
1446 };
1447 
1448 #define IDirectSoundFXEcho_QueryInterface(p,a,b)            IUnknown_QueryInterface(p,a,b)
1449 #define IDirectSoundFXEcho_AddRef(p)                        IUnknown_AddRef(p)
1450 #define IDirectSoundFXEcho_Release(p)                       IUnknown_Release(p)
1451 
1452 #if !defined(__cplusplus) || defined(CINTERFACE)
1453 #define IDirectSoundFXEcho_SetAllParameters(p,a)            (p)->lpVtbl->SetAllParameters(p,a)
1454 #define IDirectSoundFXEcho_GetAllParameters(p,a)            (p)->lpVtbl->GetAllParameters(p,a)
1455 #else // !defined(__cplusplus) || defined(CINTERFACE)
1456 #define IDirectSoundFXEcho_SetAllParameters(p,a)            (p)->SetAllParameters(a)
1457 #define IDirectSoundFXEcho_GetAllParameters(p,a)            (p)->GetAllParameters(a)
1458 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1459 
1460 //
1461 // IDirectSoundFXDistortion
1462 //
1463 
1464 DEFINE_GUID(IID_IDirectSoundFXDistortion, 0x8ecf4326, 0x455f, 0x4d8b, 0xbd, 0xa9, 0x8d, 0x5d, 0x3e, 0x9e, 0x3e, 0x0b);
1465 
1466 typedef struct _DSFXDistortion
1467 {
1468     FLOAT   fGain;
1469     FLOAT   fEdge;
1470     FLOAT   fPostEQCenterFrequency;
1471     FLOAT   fPostEQBandwidth;
1472     FLOAT   fPreLowpassCutoff;
1473 } DSFXDistortion, *LPDSFXDistortion;
1474 
1475 typedef const DSFXDistortion *LPCDSFXDistortion;
1476 
1477 #define DSFXDISTORTION_GAIN_MIN                     -60.0f
1478 #define DSFXDISTORTION_GAIN_MAX                     0.0f
1479 #define DSFXDISTORTION_EDGE_MIN                     0.0f
1480 #define DSFXDISTORTION_EDGE_MAX                     100.0f
1481 #define DSFXDISTORTION_POSTEQCENTERFREQUENCY_MIN    100.0f
1482 #define DSFXDISTORTION_POSTEQCENTERFREQUENCY_MAX    8000.0f
1483 #define DSFXDISTORTION_POSTEQBANDWIDTH_MIN          100.0f
1484 #define DSFXDISTORTION_POSTEQBANDWIDTH_MAX          8000.0f
1485 #define DSFXDISTORTION_PRELOWPASSCUTOFF_MIN         100.0f
1486 #define DSFXDISTORTION_PRELOWPASSCUTOFF_MAX         8000.0f
1487 
1488 #undef INTERFACE
1489 #define INTERFACE IDirectSoundFXDistortion
1490 
DECLARE_INTERFACE_(IDirectSoundFXDistortion,IUnknown)1491 DECLARE_INTERFACE_(IDirectSoundFXDistortion, IUnknown)
1492 {
1493     // IUnknown methods
1494     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1495     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1496     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1497 
1498     // IDirectSoundFXDistortion methods
1499     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXDistortion pcDsFxDistortion) PURE;
1500     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXDistortion pDsFxDistortion) PURE;
1501 };
1502 
1503 #define IDirectSoundFXDistortion_QueryInterface(p,a,b)      IUnknown_QueryInterface(p,a,b)
1504 #define IDirectSoundFXDistortion_AddRef(p)                  IUnknown_AddRef(p)
1505 #define IDirectSoundFXDistortion_Release(p)                 IUnknown_Release(p)
1506 
1507 #if !defined(__cplusplus) || defined(CINTERFACE)
1508 #define IDirectSoundFXDistortion_SetAllParameters(p,a)      (p)->lpVtbl->SetAllParameters(p,a)
1509 #define IDirectSoundFXDistortion_GetAllParameters(p,a)      (p)->lpVtbl->GetAllParameters(p,a)
1510 #else // !defined(__cplusplus) || defined(CINTERFACE)
1511 #define IDirectSoundFXDistortion_SetAllParameters(p,a)      (p)->SetAllParameters(a)
1512 #define IDirectSoundFXDistortion_GetAllParameters(p,a)      (p)->GetAllParameters(a)
1513 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1514 
1515 //
1516 // IDirectSoundFXCompressor
1517 //
1518 
1519 DEFINE_GUID(IID_IDirectSoundFXCompressor, 0x4bbd1154, 0x62f6, 0x4e2c, 0xa1, 0x5c, 0xd3, 0xb6, 0xc4, 0x17, 0xf7, 0xa0);
1520 
1521 typedef struct _DSFXCompressor
1522 {
1523     FLOAT   fGain;
1524     FLOAT   fAttack;
1525     FLOAT   fRelease;
1526     FLOAT   fThreshold;
1527     FLOAT   fRatio;
1528     FLOAT   fPredelay;
1529 } DSFXCompressor, *LPDSFXCompressor;
1530 
1531 typedef const DSFXCompressor *LPCDSFXCompressor;
1532 
1533 #define DSFXCOMPRESSOR_GAIN_MIN             -60.0f
1534 #define DSFXCOMPRESSOR_GAIN_MAX             60.0f
1535 #define DSFXCOMPRESSOR_ATTACK_MIN           0.01f
1536 #define DSFXCOMPRESSOR_ATTACK_MAX           500.0f
1537 #define DSFXCOMPRESSOR_RELEASE_MIN          50.0f
1538 #define DSFXCOMPRESSOR_RELEASE_MAX          3000.0f
1539 #define DSFXCOMPRESSOR_THRESHOLD_MIN        -60.0f
1540 #define DSFXCOMPRESSOR_THRESHOLD_MAX        0.0f
1541 #define DSFXCOMPRESSOR_RATIO_MIN            1.0f
1542 #define DSFXCOMPRESSOR_RATIO_MAX            100.0f
1543 #define DSFXCOMPRESSOR_PREDELAY_MIN         0.0f
1544 #define DSFXCOMPRESSOR_PREDELAY_MAX         4.0f
1545 
1546 #undef INTERFACE
1547 #define INTERFACE IDirectSoundFXCompressor
1548 
DECLARE_INTERFACE_(IDirectSoundFXCompressor,IUnknown)1549 DECLARE_INTERFACE_(IDirectSoundFXCompressor, IUnknown)
1550 {
1551     // IUnknown methods
1552     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1553     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1554     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1555 
1556     // IDirectSoundFXCompressor methods
1557     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXCompressor pcDsFxCompressor) PURE;
1558     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXCompressor pDsFxCompressor) PURE;
1559 };
1560 
1561 #define IDirectSoundFXCompressor_QueryInterface(p,a,b)      IUnknown_QueryInterface(p,a,b)
1562 #define IDirectSoundFXCompressor_AddRef(p)                  IUnknown_AddRef(p)
1563 #define IDirectSoundFXCompressor_Release(p)                 IUnknown_Release(p)
1564 
1565 #if !defined(__cplusplus) || defined(CINTERFACE)
1566 #define IDirectSoundFXCompressor_SetAllParameters(p,a)      (p)->lpVtbl->SetAllParameters(p,a)
1567 #define IDirectSoundFXCompressor_GetAllParameters(p,a)      (p)->lpVtbl->GetAllParameters(p,a)
1568 #else // !defined(__cplusplus) || defined(CINTERFACE)
1569 #define IDirectSoundFXCompressor_SetAllParameters(p,a)      (p)->SetAllParameters(a)
1570 #define IDirectSoundFXCompressor_GetAllParameters(p,a)      (p)->GetAllParameters(a)
1571 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1572 
1573 //
1574 // IDirectSoundFXParamEq
1575 //
1576 
1577 DEFINE_GUID(IID_IDirectSoundFXParamEq, 0xc03ca9fe, 0xfe90, 0x4204, 0x80, 0x78, 0x82, 0x33, 0x4c, 0xd1, 0x77, 0xda);
1578 
1579 typedef struct _DSFXParamEq
1580 {
1581     FLOAT   fCenter;
1582     FLOAT   fBandwidth;
1583     FLOAT   fGain;
1584 } DSFXParamEq, *LPDSFXParamEq;
1585 
1586 typedef const DSFXParamEq *LPCDSFXParamEq;
1587 
1588 #define DSFXPARAMEQ_CENTER_MIN      80.0f
1589 #define DSFXPARAMEQ_CENTER_MAX      16000.0f
1590 #define DSFXPARAMEQ_BANDWIDTH_MIN   1.0f
1591 #define DSFXPARAMEQ_BANDWIDTH_MAX   36.0f
1592 #define DSFXPARAMEQ_GAIN_MIN        -15.0f
1593 #define DSFXPARAMEQ_GAIN_MAX        15.0f
1594 
1595 #undef INTERFACE
1596 #define INTERFACE IDirectSoundFXParamEq
1597 
DECLARE_INTERFACE_(IDirectSoundFXParamEq,IUnknown)1598 DECLARE_INTERFACE_(IDirectSoundFXParamEq, IUnknown)
1599 {
1600     // IUnknown methods
1601     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1602     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1603     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1604 
1605     // IDirectSoundFXParamEq methods
1606     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXParamEq pcDsFxParamEq) PURE;
1607     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXParamEq pDsFxParamEq) PURE;
1608 };
1609 
1610 #define IDirectSoundFXParamEq_QueryInterface(p,a,b)      IUnknown_QueryInterface(p,a,b)
1611 #define IDirectSoundFXParamEq_AddRef(p)                  IUnknown_AddRef(p)
1612 #define IDirectSoundFXParamEq_Release(p)                 IUnknown_Release(p)
1613 
1614 #if !defined(__cplusplus) || defined(CINTERFACE)
1615 #define IDirectSoundFXParamEq_SetAllParameters(p,a)      (p)->lpVtbl->SetAllParameters(p,a)
1616 #define IDirectSoundFXParamEq_GetAllParameters(p,a)      (p)->lpVtbl->GetAllParameters(p,a)
1617 #else // !defined(__cplusplus) || defined(CINTERFACE)
1618 #define IDirectSoundFXParamEq_SetAllParameters(p,a)      (p)->SetAllParameters(a)
1619 #define IDirectSoundFXParamEq_GetAllParameters(p,a)      (p)->GetAllParameters(a)
1620 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1621 
1622 //
1623 // IDirectSoundFXI3DL2Reverb
1624 //
1625 
1626 DEFINE_GUID(IID_IDirectSoundFXI3DL2Reverb, 0x4b166a6a, 0x0d66, 0x43f3, 0x80, 0xe3, 0xee, 0x62, 0x80, 0xde, 0xe1, 0xa4);
1627 
1628 typedef struct _DSFXI3DL2Reverb
1629 {
1630     LONG    lRoom;                  // [-10000, 0]      default: -1000 mB
1631     LONG    lRoomHF;                // [-10000, 0]      default: 0 mB
1632     FLOAT   flRoomRolloffFactor;    // [0.0, 10.0]      default: 0.0
1633     FLOAT   flDecayTime;            // [0.1, 20.0]      default: 1.49s
1634     FLOAT   flDecayHFRatio;         // [0.1, 2.0]       default: 0.83
1635     LONG    lReflections;           // [-10000, 1000]   default: -2602 mB
1636     FLOAT   flReflectionsDelay;     // [0.0, 0.3]       default: 0.007 s
1637     LONG    lReverb;                // [-10000, 2000]   default: 200 mB
1638     FLOAT   flReverbDelay;          // [0.0, 0.1]       default: 0.011 s
1639     FLOAT   flDiffusion;            // [0.0, 100.0]     default: 100.0 %
1640     FLOAT   flDensity;              // [0.0, 100.0]     default: 100.0 %
1641     FLOAT   flHFReference;          // [20.0, 20000.0]  default: 5000.0 Hz
1642 } DSFXI3DL2Reverb, *LPDSFXI3DL2Reverb;
1643 
1644 typedef const DSFXI3DL2Reverb *LPCDSFXI3DL2Reverb;
1645 
1646 #define DSFX_I3DL2REVERB_ROOM_MIN                   (-10000)
1647 #define DSFX_I3DL2REVERB_ROOM_MAX                   0
1648 #define DSFX_I3DL2REVERB_ROOM_DEFAULT               (-1000)
1649 
1650 #define DSFX_I3DL2REVERB_ROOMHF_MIN                 (-10000)
1651 #define DSFX_I3DL2REVERB_ROOMHF_MAX                 0
1652 #define DSFX_I3DL2REVERB_ROOMHF_DEFAULT             (-100)
1653 
1654 #define DSFX_I3DL2REVERB_ROOMROLLOFFFACTOR_MIN      0.0f
1655 #define DSFX_I3DL2REVERB_ROOMROLLOFFFACTOR_MAX      10.0f
1656 #define DSFX_I3DL2REVERB_ROOMROLLOFFFACTOR_DEFAULT  0.0f
1657 
1658 #define DSFX_I3DL2REVERB_DECAYTIME_MIN              0.1f
1659 #define DSFX_I3DL2REVERB_DECAYTIME_MAX              20.0f
1660 #define DSFX_I3DL2REVERB_DECAYTIME_DEFAULT          1.49f
1661 
1662 #define DSFX_I3DL2REVERB_DECAYHFRATIO_MIN           0.1f
1663 #define DSFX_I3DL2REVERB_DECAYHFRATIO_MAX           2.0f
1664 #define DSFX_I3DL2REVERB_DECAYHFRATIO_DEFAULT       0.83f
1665 
1666 #define DSFX_I3DL2REVERB_REFLECTIONS_MIN            (-10000)
1667 #define DSFX_I3DL2REVERB_REFLECTIONS_MAX            1000
1668 #define DSFX_I3DL2REVERB_REFLECTIONS_DEFAULT        (-2602)
1669 
1670 #define DSFX_I3DL2REVERB_REFLECTIONSDELAY_MIN       0.0f
1671 #define DSFX_I3DL2REVERB_REFLECTIONSDELAY_MAX       0.3f
1672 #define DSFX_I3DL2REVERB_REFLECTIONSDELAY_DEFAULT   0.007f
1673 
1674 #define DSFX_I3DL2REVERB_REVERB_MIN                 (-10000)
1675 #define DSFX_I3DL2REVERB_REVERB_MAX                 2000
1676 #define DSFX_I3DL2REVERB_REVERB_DEFAULT             (200)
1677 
1678 #define DSFX_I3DL2REVERB_REVERBDELAY_MIN            0.0f
1679 #define DSFX_I3DL2REVERB_REVERBDELAY_MAX            0.1f
1680 #define DSFX_I3DL2REVERB_REVERBDELAY_DEFAULT        0.011f
1681 
1682 #define DSFX_I3DL2REVERB_DIFFUSION_MIN              0.0f
1683 #define DSFX_I3DL2REVERB_DIFFUSION_MAX              100.0f
1684 #define DSFX_I3DL2REVERB_DIFFUSION_DEFAULT          100.0f
1685 
1686 #define DSFX_I3DL2REVERB_DENSITY_MIN                0.0f
1687 #define DSFX_I3DL2REVERB_DENSITY_MAX                100.0f
1688 #define DSFX_I3DL2REVERB_DENSITY_DEFAULT            100.0f
1689 
1690 #define DSFX_I3DL2REVERB_HFREFERENCE_MIN            20.0f
1691 #define DSFX_I3DL2REVERB_HFREFERENCE_MAX            20000.0f
1692 #define DSFX_I3DL2REVERB_HFREFERENCE_DEFAULT        5000.0f
1693 
1694 #define DSFX_I3DL2REVERB_QUALITY_MIN                0
1695 #define DSFX_I3DL2REVERB_QUALITY_MAX                3
1696 #define DSFX_I3DL2REVERB_QUALITY_DEFAULT            2
1697 
1698 #undef INTERFACE
1699 #define INTERFACE IDirectSoundFXI3DL2Reverb
1700 
DECLARE_INTERFACE_(IDirectSoundFXI3DL2Reverb,IUnknown)1701 DECLARE_INTERFACE_(IDirectSoundFXI3DL2Reverb, IUnknown)
1702 {
1703     // IUnknown methods
1704     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1705     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1706     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1707 
1708     // IDirectSoundFXI3DL2Reverb methods
1709     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXI3DL2Reverb pcDsFxI3DL2Reverb) PURE;
1710     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXI3DL2Reverb pDsFxI3DL2Reverb) PURE;
1711     STDMETHOD(SetPreset)            (THIS_ DWORD dwPreset) PURE;
1712     STDMETHOD(GetPreset)            (THIS_ LPDWORD pdwPreset) PURE;
1713     STDMETHOD(SetQuality)           (THIS_ LONG lQuality) PURE;
1714     STDMETHOD(GetQuality)           (THIS_ LONG *plQuality) PURE;
1715 };
1716 
1717 #define IDirectSoundFXI3DL2Reverb_QueryInterface(p,a,b)     IUnknown_QueryInterface(p,a,b)
1718 #define IDirectSoundFXI3DL2Reverb_AddRef(p)                 IUnknown_AddRef(p)
1719 #define IDirectSoundFXI3DL2Reverb_Release(p)                IUnknown_Release(p)
1720 
1721 #if !defined(__cplusplus) || defined(CINTERFACE)
1722 #define IDirectSoundFXI3DL2Reverb_SetAllParameters(p,a)     (p)->lpVtbl->SetAllParameters(p,a)
1723 #define IDirectSoundFXI3DL2Reverb_GetAllParameters(p,a)     (p)->lpVtbl->GetAllParameters(p,a)
1724 #define IDirectSoundFXI3DL2Reverb_SetPreset(p,a)            (p)->lpVtbl->SetPreset(p,a)
1725 #define IDirectSoundFXI3DL2Reverb_GetPreset(p,a)            (p)->lpVtbl->GetPreset(p,a)
1726 #else // !defined(__cplusplus) || defined(CINTERFACE)
1727 #define IDirectSoundFXI3DL2Reverb_SetAllParameters(p,a)     (p)->SetAllParameters(a)
1728 #define IDirectSoundFXI3DL2Reverb_GetAllParameters(p,a)     (p)->GetAllParameters(a)
1729 #define IDirectSoundFXI3DL2Reverb_SetPreset(p,a)            (p)->SetPreset(a)
1730 #define IDirectSoundFXI3DL2Reverb_GetPreset(p,a)            (p)->GetPreset(a)
1731 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1732 
1733 //
1734 // IDirectSoundFXWavesReverb
1735 //
1736 
1737 DEFINE_GUID(IID_IDirectSoundFXWavesReverb,0x46858c3a,0x0dc6,0x45e3,0xb7,0x60,0xd4,0xee,0xf1,0x6c,0xb3,0x25);
1738 
1739 typedef struct _DSFXWavesReverb
1740 {
1741     FLOAT   fInGain;                // [-96.0,0.0]            default: 0.0 dB
1742     FLOAT   fReverbMix;             // [-96.0,0.0]            default: 0.0 db
1743     FLOAT   fReverbTime;            // [0.001,3000.0]         default: 1000.0 ms
1744     FLOAT   fHighFreqRTRatio;       // [0.001,0.999]          default: 0.001
1745 } DSFXWavesReverb, *LPDSFXWavesReverb;
1746 
1747 typedef const DSFXWavesReverb *LPCDSFXWavesReverb;
1748 
1749 #define DSFX_WAVESREVERB_INGAIN_MIN                 -96.0f
1750 #define DSFX_WAVESREVERB_INGAIN_MAX                 0.0f
1751 #define DSFX_WAVESREVERB_INGAIN_DEFAULT             0.0f
1752 #define DSFX_WAVESREVERB_REVERBMIX_MIN              -96.0f
1753 #define DSFX_WAVESREVERB_REVERBMIX_MAX              0.0f
1754 #define DSFX_WAVESREVERB_REVERBMIX_DEFAULT          0.0f
1755 #define DSFX_WAVESREVERB_REVERBTIME_MIN             0.001f
1756 #define DSFX_WAVESREVERB_REVERBTIME_MAX             3000.0f
1757 #define DSFX_WAVESREVERB_REVERBTIME_DEFAULT         1000.0f
1758 #define DSFX_WAVESREVERB_HIGHFREQRTRATIO_MIN        0.001f
1759 #define DSFX_WAVESREVERB_HIGHFREQRTRATIO_MAX        0.999f
1760 #define DSFX_WAVESREVERB_HIGHFREQRTRATIO_DEFAULT    0.001f
1761 
1762 #undef INTERFACE
1763 #define INTERFACE IDirectSoundFXWavesReverb
1764 
DECLARE_INTERFACE_(IDirectSoundFXWavesReverb,IUnknown)1765 DECLARE_INTERFACE_(IDirectSoundFXWavesReverb, IUnknown)
1766 {
1767     // IUnknown methods
1768     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1769     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1770     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1771 
1772     // IDirectSoundFXWavesReverb methods
1773     STDMETHOD(SetAllParameters)     (THIS_ LPCDSFXWavesReverb pcDsFxWavesReverb) PURE;
1774     STDMETHOD(GetAllParameters)     (THIS_ LPDSFXWavesReverb pDsFxWavesReverb) PURE;
1775 };
1776 
1777 #define IDirectSoundFXWavesReverb_QueryInterface(p,a,b)     IUnknown_QueryInterface(p,a,b)
1778 #define IDirectSoundFXWavesReverb_AddRef(p)                 IUnknown_AddRef(p)
1779 #define IDirectSoundFXWavesReverb_Release(p)                IUnknown_Release(p)
1780 
1781 #if !defined(__cplusplus) || defined(CINTERFACE)
1782 #define IDirectSoundFXWavesReverb_SetAllParameters(p,a)     (p)->lpVtbl->SetAllParameters(p,a)
1783 #define IDirectSoundFXWavesReverb_GetAllParameters(p,a)     (p)->lpVtbl->GetAllParameters(p,a)
1784 #else // !defined(__cplusplus) || defined(CINTERFACE)
1785 #define IDirectSoundFXWavesReverb_SetAllParameters(p,a)     (p)->SetAllParameters(a)
1786 #define IDirectSoundFXWavesReverb_GetAllParameters(p,a)     (p)->GetAllParameters(a)
1787 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1788 
1789 //
1790 // IDirectSoundCaptureFXAec
1791 //
1792 
1793 DEFINE_GUID(IID_IDirectSoundCaptureFXAec, 0xad74143d, 0x903d, 0x4ab7, 0x80, 0x66, 0x28, 0xd3, 0x63, 0x03, 0x6d, 0x65);
1794 
1795 typedef struct _DSCFXAec
1796 {
1797     BOOL    fEnable;
1798     BOOL    fNoiseFill;
1799     DWORD   dwMode;
1800 } DSCFXAec, *LPDSCFXAec;
1801 
1802 typedef const DSCFXAec *LPCDSCFXAec;
1803 
1804 // These match the AEC_MODE_* constants in the DDK's ksmedia.h file
1805 #define DSCFX_AEC_MODE_PASS_THROUGH                     0x0
1806 #define DSCFX_AEC_MODE_HALF_DUPLEX                      0x1
1807 #define DSCFX_AEC_MODE_FULL_DUPLEX                      0x2
1808 
1809 // These match the AEC_STATUS_* constants in ksmedia.h
1810 #define DSCFX_AEC_STATUS_HISTORY_UNINITIALIZED          0x0
1811 #define DSCFX_AEC_STATUS_HISTORY_CONTINUOUSLY_CONVERGED 0x1
1812 #define DSCFX_AEC_STATUS_HISTORY_PREVIOUSLY_DIVERGED    0x2
1813 #define DSCFX_AEC_STATUS_CURRENTLY_CONVERGED            0x8
1814 
1815 #undef INTERFACE
1816 #define INTERFACE IDirectSoundCaptureFXAec
1817 
DECLARE_INTERFACE_(IDirectSoundCaptureFXAec,IUnknown)1818 DECLARE_INTERFACE_(IDirectSoundCaptureFXAec, IUnknown)
1819 {
1820     // IUnknown methods
1821     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1822     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1823     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1824 
1825     // IDirectSoundCaptureFXAec methods
1826     STDMETHOD(SetAllParameters)     (THIS_ LPCDSCFXAec pDscFxAec) PURE;
1827     STDMETHOD(GetAllParameters)     (THIS_ LPDSCFXAec pDscFxAec) PURE;
1828     STDMETHOD(GetStatus)            (THIS_ PDWORD pdwStatus) PURE;
1829     STDMETHOD(Reset)                (THIS) PURE;
1830 };
1831 
1832 #define IDirectSoundCaptureFXAec_QueryInterface(p,a,b)     IUnknown_QueryInterface(p,a,b)
1833 #define IDirectSoundCaptureFXAec_AddRef(p)                 IUnknown_AddRef(p)
1834 #define IDirectSoundCaptureFXAec_Release(p)                IUnknown_Release(p)
1835 
1836 #if !defined(__cplusplus) || defined(CINTERFACE)
1837 #define IDirectSoundCaptureFXAec_SetAllParameters(p,a)     (p)->lpVtbl->SetAllParameters(p,a)
1838 #define IDirectSoundCaptureFXAec_GetAllParameters(p,a)     (p)->lpVtbl->GetAllParameters(p,a)
1839 #else // !defined(__cplusplus) || defined(CINTERFACE)
1840 #define IDirectSoundCaptureFXAec_SetAllParameters(p,a)     (p)->SetAllParameters(a)
1841 #define IDirectSoundCaptureFXAec_GetAllParameters(p,a)     (p)->GetAllParameters(a)
1842 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1843 
1844 
1845 //
1846 // IDirectSoundCaptureFXNoiseSuppress
1847 //
1848 
1849 DEFINE_GUID(IID_IDirectSoundCaptureFXNoiseSuppress, 0xed311e41, 0xfbae, 0x4175, 0x96, 0x25, 0xcd, 0x8, 0x54, 0xf6, 0x93, 0xca);
1850 
1851 typedef struct _DSCFXNoiseSuppress
1852 {
1853     BOOL    fEnable;
1854 } DSCFXNoiseSuppress, *LPDSCFXNoiseSuppress;
1855 
1856 typedef const DSCFXNoiseSuppress *LPCDSCFXNoiseSuppress;
1857 
1858 #undef INTERFACE
1859 #define INTERFACE IDirectSoundCaptureFXNoiseSuppress
1860 
DECLARE_INTERFACE_(IDirectSoundCaptureFXNoiseSuppress,IUnknown)1861 DECLARE_INTERFACE_(IDirectSoundCaptureFXNoiseSuppress, IUnknown)
1862 {
1863     // IUnknown methods
1864     STDMETHOD(QueryInterface)       (THIS_ REFIID, LPVOID *) PURE;
1865     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
1866     STDMETHOD_(ULONG,Release)       (THIS) PURE;
1867 
1868     // IDirectSoundCaptureFXNoiseSuppress methods
1869     STDMETHOD(SetAllParameters)     (THIS_ LPCDSCFXNoiseSuppress pcDscFxNoiseSuppress) PURE;
1870     STDMETHOD(GetAllParameters)     (THIS_ LPDSCFXNoiseSuppress pDscFxNoiseSuppress) PURE;
1871     STDMETHOD(Reset)                (THIS) PURE;
1872 };
1873 
1874 #define IDirectSoundCaptureFXNoiseSuppress_QueryInterface(p,a,b)     IUnknown_QueryInterface(p,a,b)
1875 #define IDirectSoundCaptureFXNoiseSuppress_AddRef(p)                 IUnknown_AddRef(p)
1876 #define IDirectSoundCaptureFXNoiseSuppress_Release(p)                IUnknown_Release(p)
1877 
1878 #if !defined(__cplusplus) || defined(CINTERFACE)
1879 #define IDirectSoundCaptureFXNoiseSuppress_SetAllParameters(p,a)     (p)->lpVtbl->SetAllParameters(p,a)
1880 #define IDirectSoundCaptureFXNoiseSuppress_GetAllParameters(p,a)     (p)->lpVtbl->GetAllParameters(p,a)
1881 #else // !defined(__cplusplus) || defined(CINTERFACE)
1882 #define IDirectSoundCaptureFXNoiseSuppress_SetAllParameters(p,a)     (p)->SetAllParameters(a)
1883 #define IDirectSoundCaptureFXNoiseSuppress_GetAllParameters(p,a)     (p)->GetAllParameters(a)
1884 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1885 
1886 
1887 //
1888 // IDirectSoundFullDuplex
1889 //
1890 
1891 #ifndef _IDirectSoundFullDuplex_
1892 #define _IDirectSoundFullDuplex_
1893 
1894 #ifdef __cplusplus
1895 // 'struct' not 'class' per the way DECLARE_INTERFACE_ is defined
1896 struct IDirectSoundFullDuplex;
1897 #endif // __cplusplus
1898 
1899 typedef struct IDirectSoundFullDuplex *LPDIRECTSOUNDFULLDUPLEX;
1900 
1901 DEFINE_GUID(IID_IDirectSoundFullDuplex, 0xedcb4c7a, 0xdaab, 0x4216, 0xa4, 0x2e, 0x6c, 0x50, 0x59, 0x6d, 0xdc, 0x1d);
1902 
1903 #undef INTERFACE
1904 #define INTERFACE IDirectSoundFullDuplex
1905 
DECLARE_INTERFACE_(IDirectSoundFullDuplex,IUnknown)1906 DECLARE_INTERFACE_(IDirectSoundFullDuplex, IUnknown)
1907 {
1908     // IUnknown methods
1909     STDMETHOD(QueryInterface)   (THIS_ REFIID, LPVOID *) PURE;
1910     STDMETHOD_(ULONG,AddRef)    (THIS) PURE;
1911     STDMETHOD_(ULONG,Release)   (THIS) PURE;
1912 
1913     // IDirectSoundFullDuplex methods
1914     STDMETHOD(Initialize)     (THIS_ LPCGUID pCaptureGuid, LPCGUID pRenderGuid, LPCDSCBUFFERDESC lpDscBufferDesc, LPCDSBUFFERDESC lpDsBufferDesc, HWND hWnd, DWORD dwLevel, LPLPDIRECTSOUNDCAPTUREBUFFER8 lplpDirectSoundCaptureBuffer8, LPLPDIRECTSOUNDBUFFER8 lplpDirectSoundBuffer8) PURE;
1915 };
1916 
1917 #define IDirectSoundFullDuplex_QueryInterface(p,a,b)    IUnknown_QueryInterface(p,a,b)
1918 #define IDirectSoundFullDuplex_AddRef(p)                IUnknown_AddRef(p)
1919 #define IDirectSoundFullDuplex_Release(p)               IUnknown_Release(p)
1920 
1921 #if !defined(__cplusplus) || defined(CINTERFACE)
1922 #define IDirectSoundFullDuplex_Initialize(p,a,b,c,d,e,f,g,h)     (p)->lpVtbl->Initialize(p,a,b,c,d,e,f,g,h)
1923 #else // !defined(__cplusplus) || defined(CINTERFACE)
1924 #define IDirectSoundFullDuplex_Initialize(p,a,b,c,d,e,f,g,h)     (p)->Initialize(a,b,c,d,e,f,g,h)
1925 #endif // !defined(__cplusplus) || defined(CINTERFACE)
1926 
1927 #endif // _IDirectSoundFullDuplex_
1928 
1929 #endif // DIRECTSOUND_VERSION >= 0x0800
1930 
1931 //
1932 // Return Codes
1933 //
1934 
1935 // The function completed successfully
1936 #define DS_OK                           S_OK
1937 
1938 // The call succeeded, but we had to substitute the 3D algorithm
1939 #define DS_NO_VIRTUALIZATION            MAKE_HRESULT(0, _FACDS, 10)
1940 
1941 // The call failed because resources (such as a priority level)
1942 // were already being used by another caller
1943 #define DSERR_ALLOCATED                 MAKE_DSHRESULT(10)
1944 
1945 // The control (vol, pan, etc.) requested by the caller is not available
1946 #define DSERR_CONTROLUNAVAIL            MAKE_DSHRESULT(30)
1947 
1948 // An invalid parameter was passed to the returning function
1949 #define DSERR_INVALIDPARAM              E_INVALIDARG
1950 
1951 // This call is not valid for the current state of this object
1952 #define DSERR_INVALIDCALL               MAKE_DSHRESULT(50)
1953 
1954 // An undetermined error occurred inside the DirectSound subsystem
1955 #define DSERR_GENERIC                   E_FAIL
1956 
1957 // The caller does not have the priority level required for the function to
1958 // succeed
1959 #define DSERR_PRIOLEVELNEEDED           MAKE_DSHRESULT(70)
1960 
1961 // Not enough free memory is available to complete the operation
1962 #define DSERR_OUTOFMEMORY               E_OUTOFMEMORY
1963 
1964 // The specified WAVE format is not supported
1965 #define DSERR_BADFORMAT                 MAKE_DSHRESULT(100)
1966 
1967 // The function called is not supported at this time
1968 #define DSERR_UNSUPPORTED               E_NOTIMPL
1969 
1970 // No sound driver is available for use
1971 #define DSERR_NODRIVER                  MAKE_DSHRESULT(120)
1972 // This object is already initialized
1973 #define DSERR_ALREADYINITIALIZED        MAKE_DSHRESULT(130)
1974 
1975 // This object does not support aggregation
1976 #define DSERR_NOAGGREGATION             CLASS_E_NOAGGREGATION
1977 
1978 // The buffer memory has been lost, and must be restored
1979 #define DSERR_BUFFERLOST                MAKE_DSHRESULT(150)
1980 
1981 // Another app has a higher priority level, preventing this call from
1982 // succeeding
1983 #define DSERR_OTHERAPPHASPRIO           MAKE_DSHRESULT(160)
1984 
1985 // This object has not been initialized
1986 #define DSERR_UNINITIALIZED             MAKE_DSHRESULT(170)
1987 
1988 // The requested COM interface is not available
1989 #define DSERR_NOINTERFACE               E_NOINTERFACE
1990 
1991 // Access is denied
1992 #define DSERR_ACCESSDENIED              E_ACCESSDENIED
1993 
1994 // Tried to create a DSBCAPS_CTRLFX buffer shorter than DSBSIZE_FX_MIN milliseconds
1995 #define DSERR_BUFFERTOOSMALL            MAKE_DSHRESULT(180)
1996 
1997 // Attempt to use DirectSound 8 functionality on an older DirectSound object
1998 #define DSERR_DS8_REQUIRED              MAKE_DSHRESULT(190)
1999 
2000 // A circular loop of send effects was detected
2001 #define DSERR_SENDLOOP                  MAKE_DSHRESULT(200)
2002 
2003 // The GUID specified in an audiopath file does not match a valid MIXIN buffer
2004 #define DSERR_BADSENDBUFFERGUID         MAKE_DSHRESULT(210)
2005 
2006 // The object requested was not found (numerically equal to DMUS_E_NOT_FOUND)
2007 #define DSERR_OBJECTNOTFOUND            MAKE_DSHRESULT(4449)
2008 
2009 // The effects requested could not be found on the system, or they were found
2010 // but in the wrong order, or in the wrong hardware/software locations.
2011 #define DSERR_FXUNAVAILABLE             MAKE_DSHRESULT(220)
2012 
2013 //
2014 // Flags
2015 //
2016 
2017 #define DSCAPS_PRIMARYMONO          0x00000001
2018 #define DSCAPS_PRIMARYSTEREO        0x00000002
2019 #define DSCAPS_PRIMARY8BIT          0x00000004
2020 #define DSCAPS_PRIMARY16BIT         0x00000008
2021 #define DSCAPS_CONTINUOUSRATE       0x00000010
2022 #define DSCAPS_EMULDRIVER           0x00000020
2023 #define DSCAPS_CERTIFIED            0x00000040
2024 #define DSCAPS_SECONDARYMONO        0x00000100
2025 #define DSCAPS_SECONDARYSTEREO      0x00000200
2026 #define DSCAPS_SECONDARY8BIT        0x00000400
2027 #define DSCAPS_SECONDARY16BIT       0x00000800
2028 
2029 #define DSSCL_NORMAL                0x00000001
2030 #define DSSCL_PRIORITY              0x00000002
2031 #define DSSCL_EXCLUSIVE             0x00000003
2032 #define DSSCL_WRITEPRIMARY          0x00000004
2033 
2034 #define DSSPEAKER_DIRECTOUT         0x00000000
2035 #define DSSPEAKER_HEADPHONE         0x00000001
2036 #define DSSPEAKER_MONO              0x00000002
2037 #define DSSPEAKER_QUAD              0x00000003
2038 #define DSSPEAKER_STEREO            0x00000004
2039 #define DSSPEAKER_SURROUND          0x00000005
2040 #define DSSPEAKER_5POINT1           0x00000006  // obsolete 5.1 setting
2041 #define DSSPEAKER_7POINT1           0x00000007  // obsolete 7.1 setting
2042 #define DSSPEAKER_7POINT1_SURROUND  0x00000008  // correct 7.1 Home Theater setting
2043 #define DSSPEAKER_7POINT1_WIDE      DSSPEAKER_7POINT1
2044 #if (DIRECTSOUND_VERSION >= 0x1000)
2045     #define DSSPEAKER_5POINT1_SURROUND  0x00000009  // correct 5.1 setting
2046     #define DSSPEAKER_5POINT1_BACK      DSSPEAKER_5POINT1
2047 #endif
2048 
2049 #define DSSPEAKER_GEOMETRY_MIN      0x00000005  //   5 degrees
2050 #define DSSPEAKER_GEOMETRY_NARROW   0x0000000A  //  10 degrees
2051 #define DSSPEAKER_GEOMETRY_WIDE     0x00000014  //  20 degrees
2052 #define DSSPEAKER_GEOMETRY_MAX      0x000000B4  // 180 degrees
2053 
2054 #define DSSPEAKER_COMBINED(c, g)    ((DWORD)(((BYTE)(c)) | ((DWORD)((BYTE)(g))) << 16))
2055 #define DSSPEAKER_CONFIG(a)         ((BYTE)(a))
2056 #define DSSPEAKER_GEOMETRY(a)       ((BYTE)(((DWORD)(a) >> 16) & 0x00FF))
2057 
2058 #define DSBCAPS_PRIMARYBUFFER       0x00000001
2059 #define DSBCAPS_STATIC              0x00000002
2060 #define DSBCAPS_LOCHARDWARE         0x00000004
2061 #define DSBCAPS_LOCSOFTWARE         0x00000008
2062 #define DSBCAPS_CTRL3D              0x00000010
2063 #define DSBCAPS_CTRLFREQUENCY       0x00000020
2064 #define DSBCAPS_CTRLPAN             0x00000040
2065 #define DSBCAPS_CTRLVOLUME          0x00000080
2066 #define DSBCAPS_CTRLPOSITIONNOTIFY  0x00000100
2067 #define DSBCAPS_CTRLFX              0x00000200
2068 #define DSBCAPS_STICKYFOCUS         0x00004000
2069 #define DSBCAPS_GLOBALFOCUS         0x00008000
2070 #define DSBCAPS_GETCURRENTPOSITION2 0x00010000
2071 #define DSBCAPS_MUTE3DATMAXDISTANCE 0x00020000
2072 #define DSBCAPS_LOCDEFER            0x00040000
2073 #if (DIRECTSOUND_VERSION >= 0x1000)
2074     // Force GetCurrentPosition() to return a buffer's true play position;
2075     // unmodified by aids to enhance backward compatibility.
2076     #define DSBCAPS_TRUEPLAYPOSITION    0x00080000
2077 #endif
2078 
2079 #define DSBPLAY_LOOPING             0x00000001
2080 #define DSBPLAY_LOCHARDWARE         0x00000002
2081 #define DSBPLAY_LOCSOFTWARE         0x00000004
2082 #define DSBPLAY_TERMINATEBY_TIME    0x00000008
2083 #define DSBPLAY_TERMINATEBY_DISTANCE    0x000000010
2084 #define DSBPLAY_TERMINATEBY_PRIORITY    0x000000020
2085 
2086 #define DSBSTATUS_PLAYING           0x00000001
2087 #define DSBSTATUS_BUFFERLOST        0x00000002
2088 #define DSBSTATUS_LOOPING           0x00000004
2089 #define DSBSTATUS_LOCHARDWARE       0x00000008
2090 #define DSBSTATUS_LOCSOFTWARE       0x00000010
2091 #define DSBSTATUS_TERMINATED        0x00000020
2092 
2093 #define DSBLOCK_FROMWRITECURSOR     0x00000001
2094 #define DSBLOCK_ENTIREBUFFER        0x00000002
2095 
2096 #define DSBFREQUENCY_ORIGINAL       0
2097 #define DSBFREQUENCY_MIN            100
2098 #if DIRECTSOUND_VERSION >= 0x0900
2099 #define DSBFREQUENCY_MAX            200000
2100 #else
2101 #define DSBFREQUENCY_MAX            100000
2102 #endif
2103 
2104 #define DSBPAN_LEFT                 -10000
2105 #define DSBPAN_CENTER               0
2106 #define DSBPAN_RIGHT                10000
2107 
2108 #define DSBVOLUME_MIN               -10000
2109 #define DSBVOLUME_MAX               0
2110 
2111 #define DSBSIZE_MIN                 4
2112 #define DSBSIZE_MAX                 0x0FFFFFFF
2113 #define DSBSIZE_FX_MIN              150  // NOTE: Milliseconds, not bytes
2114 
2115 #define DSBNOTIFICATIONS_MAX        100000UL
2116 
2117 #define DS3DMODE_NORMAL             0x00000000
2118 #define DS3DMODE_HEADRELATIVE       0x00000001
2119 #define DS3DMODE_DISABLE            0x00000002
2120 
2121 #define DS3D_IMMEDIATE              0x00000000
2122 #define DS3D_DEFERRED               0x00000001
2123 
2124 #define DS3D_MINDISTANCEFACTOR      FLT_MIN
2125 #define DS3D_MAXDISTANCEFACTOR      FLT_MAX
2126 #define DS3D_DEFAULTDISTANCEFACTOR  1.0f
2127 
2128 #define DS3D_MINROLLOFFFACTOR       0.0f
2129 #define DS3D_MAXROLLOFFFACTOR       10.0f
2130 #define DS3D_DEFAULTROLLOFFFACTOR   1.0f
2131 
2132 #define DS3D_MINDOPPLERFACTOR       0.0f
2133 #define DS3D_MAXDOPPLERFACTOR       10.0f
2134 #define DS3D_DEFAULTDOPPLERFACTOR   1.0f
2135 
2136 #define DS3D_DEFAULTMINDISTANCE     1.0f
2137 #define DS3D_DEFAULTMAXDISTANCE     1000000000.0f
2138 
2139 #define DS3D_MINCONEANGLE           0
2140 #define DS3D_MAXCONEANGLE           360
2141 #define DS3D_DEFAULTCONEANGLE       360
2142 
2143 #define DS3D_DEFAULTCONEOUTSIDEVOLUME DSBVOLUME_MAX
2144 
2145 // IDirectSoundCapture attributes
2146 
2147 #define DSCCAPS_EMULDRIVER          DSCAPS_EMULDRIVER
2148 #define DSCCAPS_CERTIFIED           DSCAPS_CERTIFIED
2149 #define DSCCAPS_MULTIPLECAPTURE     0x00000001
2150 
2151 // IDirectSoundCaptureBuffer attributes
2152 
2153 #define DSCBCAPS_WAVEMAPPED         0x80000000
2154 
2155 #if DIRECTSOUND_VERSION >= 0x0800
2156 #define DSCBCAPS_CTRLFX             0x00000200
2157 #endif
2158 
2159 
2160 #define DSCBLOCK_ENTIREBUFFER       0x00000001
2161 
2162 #define DSCBSTATUS_CAPTURING        0x00000001
2163 #define DSCBSTATUS_LOOPING          0x00000002
2164 
2165 #define DSCBSTART_LOOPING           0x00000001
2166 
2167 #define DSBPN_OFFSETSTOP            0xFFFFFFFF
2168 
2169 #define DS_CERTIFIED                0x00000000
2170 #define DS_UNCERTIFIED              0x00000001
2171 
2172 
2173 //
2174 // Flags for the I3DL2 effects
2175 //
2176 
2177 //
2178 // I3DL2 Material Presets
2179 //
2180 
2181 enum
2182 {
2183     DSFX_I3DL2_MATERIAL_PRESET_SINGLEWINDOW,
2184     DSFX_I3DL2_MATERIAL_PRESET_DOUBLEWINDOW,
2185     DSFX_I3DL2_MATERIAL_PRESET_THINDOOR,
2186     DSFX_I3DL2_MATERIAL_PRESET_THICKDOOR,
2187     DSFX_I3DL2_MATERIAL_PRESET_WOODWALL,
2188     DSFX_I3DL2_MATERIAL_PRESET_BRICKWALL,
2189     DSFX_I3DL2_MATERIAL_PRESET_STONEWALL,
2190     DSFX_I3DL2_MATERIAL_PRESET_CURTAIN
2191 };
2192 
2193 #define I3DL2_MATERIAL_PRESET_SINGLEWINDOW    -2800,0.71f
2194 #define I3DL2_MATERIAL_PRESET_DOUBLEWINDOW    -5000,0.40f
2195 #define I3DL2_MATERIAL_PRESET_THINDOOR        -1800,0.66f
2196 #define I3DL2_MATERIAL_PRESET_THICKDOOR       -4400,0.64f
2197 #define I3DL2_MATERIAL_PRESET_WOODWALL        -4000,0.50f
2198 #define I3DL2_MATERIAL_PRESET_BRICKWALL       -5000,0.60f
2199 #define I3DL2_MATERIAL_PRESET_STONEWALL       -6000,0.68f
2200 #define I3DL2_MATERIAL_PRESET_CURTAIN         -1200,0.15f
2201 
2202 enum
2203 {
2204     DSFX_I3DL2_ENVIRONMENT_PRESET_DEFAULT,
2205     DSFX_I3DL2_ENVIRONMENT_PRESET_GENERIC,
2206     DSFX_I3DL2_ENVIRONMENT_PRESET_PADDEDCELL,
2207     DSFX_I3DL2_ENVIRONMENT_PRESET_ROOM,
2208     DSFX_I3DL2_ENVIRONMENT_PRESET_BATHROOM,
2209     DSFX_I3DL2_ENVIRONMENT_PRESET_LIVINGROOM,
2210     DSFX_I3DL2_ENVIRONMENT_PRESET_STONEROOM,
2211     DSFX_I3DL2_ENVIRONMENT_PRESET_AUDITORIUM,
2212     DSFX_I3DL2_ENVIRONMENT_PRESET_CONCERTHALL,
2213     DSFX_I3DL2_ENVIRONMENT_PRESET_CAVE,
2214     DSFX_I3DL2_ENVIRONMENT_PRESET_ARENA,
2215     DSFX_I3DL2_ENVIRONMENT_PRESET_HANGAR,
2216     DSFX_I3DL2_ENVIRONMENT_PRESET_CARPETEDHALLWAY,
2217     DSFX_I3DL2_ENVIRONMENT_PRESET_HALLWAY,
2218     DSFX_I3DL2_ENVIRONMENT_PRESET_STONECORRIDOR,
2219     DSFX_I3DL2_ENVIRONMENT_PRESET_ALLEY,
2220     DSFX_I3DL2_ENVIRONMENT_PRESET_FOREST,
2221     DSFX_I3DL2_ENVIRONMENT_PRESET_CITY,
2222     DSFX_I3DL2_ENVIRONMENT_PRESET_MOUNTAINS,
2223     DSFX_I3DL2_ENVIRONMENT_PRESET_QUARRY,
2224     DSFX_I3DL2_ENVIRONMENT_PRESET_PLAIN,
2225     DSFX_I3DL2_ENVIRONMENT_PRESET_PARKINGLOT,
2226     DSFX_I3DL2_ENVIRONMENT_PRESET_SEWERPIPE,
2227     DSFX_I3DL2_ENVIRONMENT_PRESET_UNDERWATER,
2228     DSFX_I3DL2_ENVIRONMENT_PRESET_SMALLROOM,
2229     DSFX_I3DL2_ENVIRONMENT_PRESET_MEDIUMROOM,
2230     DSFX_I3DL2_ENVIRONMENT_PRESET_LARGEROOM,
2231     DSFX_I3DL2_ENVIRONMENT_PRESET_MEDIUMHALL,
2232     DSFX_I3DL2_ENVIRONMENT_PRESET_LARGEHALL,
2233     DSFX_I3DL2_ENVIRONMENT_PRESET_PLATE
2234 };
2235 
2236 //
2237 // I3DL2 Reverberation Presets Values
2238 //
2239 
2240 #define I3DL2_ENVIRONMENT_PRESET_DEFAULT         -1000, -100, 0.0f, 1.49f, 0.83f, -2602, 0.007f,   200, 0.011f, 100.0f, 100.0f, 5000.0f
2241 #define I3DL2_ENVIRONMENT_PRESET_GENERIC         -1000, -100, 0.0f, 1.49f, 0.83f, -2602, 0.007f,   200, 0.011f, 100.0f, 100.0f, 5000.0f
2242 #define I3DL2_ENVIRONMENT_PRESET_PADDEDCELL      -1000,-6000, 0.0f, 0.17f, 0.10f, -1204, 0.001f,   207, 0.002f, 100.0f, 100.0f, 5000.0f
2243 #define I3DL2_ENVIRONMENT_PRESET_ROOM            -1000, -454, 0.0f, 0.40f, 0.83f, -1646, 0.002f,    53, 0.003f, 100.0f, 100.0f, 5000.0f
2244 #define I3DL2_ENVIRONMENT_PRESET_BATHROOM        -1000,-1200, 0.0f, 1.49f, 0.54f,  -370, 0.007f,  1030, 0.011f, 100.0f,  60.0f, 5000.0f
2245 #define I3DL2_ENVIRONMENT_PRESET_LIVINGROOM      -1000,-6000, 0.0f, 0.50f, 0.10f, -1376, 0.003f, -1104, 0.004f, 100.0f, 100.0f, 5000.0f
2246 #define I3DL2_ENVIRONMENT_PRESET_STONEROOM       -1000, -300, 0.0f, 2.31f, 0.64f,  -711, 0.012f,    83, 0.017f, 100.0f, 100.0f, 5000.0f
2247 #define I3DL2_ENVIRONMENT_PRESET_AUDITORIUM      -1000, -476, 0.0f, 4.32f, 0.59f,  -789, 0.020f,  -289, 0.030f, 100.0f, 100.0f, 5000.0f
2248 #define I3DL2_ENVIRONMENT_PRESET_CONCERTHALL     -1000, -500, 0.0f, 3.92f, 0.70f, -1230, 0.020f,    -2, 0.029f, 100.0f, 100.0f, 5000.0f
2249 #define I3DL2_ENVIRONMENT_PRESET_CAVE            -1000,    0, 0.0f, 2.91f, 1.30f,  -602, 0.015f,  -302, 0.022f, 100.0f, 100.0f, 5000.0f
2250 #define I3DL2_ENVIRONMENT_PRESET_ARENA           -1000, -698, 0.0f, 7.24f, 0.33f, -1166, 0.020f,    16, 0.030f, 100.0f, 100.0f, 5000.0f
2251 #define I3DL2_ENVIRONMENT_PRESET_HANGAR          -1000,-1000, 0.0f,10.05f, 0.23f,  -602, 0.020f,   198, 0.030f, 100.0f, 100.0f, 5000.0f
2252 #define I3DL2_ENVIRONMENT_PRESET_CARPETEDHALLWAY -1000,-4000, 0.0f, 0.30f, 0.10f, -1831, 0.002f, -1630, 0.030f, 100.0f, 100.0f, 5000.0f
2253 #define I3DL2_ENVIRONMENT_PRESET_HALLWAY         -1000, -300, 0.0f, 1.49f, 0.59f, -1219, 0.007f,   441, 0.011f, 100.0f, 100.0f, 5000.0f
2254 #define I3DL2_ENVIRONMENT_PRESET_STONECORRIDOR   -1000, -237, 0.0f, 2.70f, 0.79f, -1214, 0.013f,   395, 0.020f, 100.0f, 100.0f, 5000.0f
2255 #define I3DL2_ENVIRONMENT_PRESET_ALLEY           -1000, -270, 0.0f, 1.49f, 0.86f, -1204, 0.007f,    -4, 0.011f, 100.0f, 100.0f, 5000.0f
2256 #define I3DL2_ENVIRONMENT_PRESET_FOREST          -1000,-3300, 0.0f, 1.49f, 0.54f, -2560, 0.162f,  -613, 0.088f,  79.0f, 100.0f, 5000.0f
2257 #define I3DL2_ENVIRONMENT_PRESET_CITY            -1000, -800, 0.0f, 1.49f, 0.67f, -2273, 0.007f, -2217, 0.011f,  50.0f, 100.0f, 5000.0f
2258 #define I3DL2_ENVIRONMENT_PRESET_MOUNTAINS       -1000,-2500, 0.0f, 1.49f, 0.21f, -2780, 0.300f, -2014, 0.100f,  27.0f, 100.0f, 5000.0f
2259 #define I3DL2_ENVIRONMENT_PRESET_QUARRY          -1000,-1000, 0.0f, 1.49f, 0.83f,-10000, 0.061f,   500, 0.025f, 100.0f, 100.0f, 5000.0f
2260 #define I3DL2_ENVIRONMENT_PRESET_PLAIN           -1000,-2000, 0.0f, 1.49f, 0.50f, -2466, 0.179f, -2514, 0.100f,  21.0f, 100.0f, 5000.0f
2261 #define I3DL2_ENVIRONMENT_PRESET_PARKINGLOT      -1000,    0, 0.0f, 1.65f, 1.50f, -1363, 0.008f, -1153, 0.012f, 100.0f, 100.0f, 5000.0f
2262 #define I3DL2_ENVIRONMENT_PRESET_SEWERPIPE       -1000,-1000, 0.0f, 2.81f, 0.14f,   429, 0.014f,   648, 0.021f,  80.0f,  60.0f, 5000.0f
2263 #define I3DL2_ENVIRONMENT_PRESET_UNDERWATER      -1000,-4000, 0.0f, 1.49f, 0.10f,  -449, 0.007f,  1700, 0.011f, 100.0f, 100.0f, 5000.0f
2264 
2265 //
2266 // Examples simulating 'musical' reverb presets
2267 //
2268 // Name       Decay time   Description
2269 // Small Room    1.1s      A small size room with a length of 5m or so.
2270 // Medium Room   1.3s      A medium size room with a length of 10m or so.
2271 // Large Room    1.5s      A large size room suitable for live performances.
2272 // Medium Hall   1.8s      A medium size concert hall.
2273 // Large Hall    1.8s      A large size concert hall suitable for a full orchestra.
2274 // Plate         1.3s      A plate reverb simulation.
2275 //
2276 
2277 #define I3DL2_ENVIRONMENT_PRESET_SMALLROOM       -1000, -600, 0.0f, 1.10f, 0.83f,  -400, 0.005f,   500, 0.010f, 100.0f, 100.0f, 5000.0f
2278 #define I3DL2_ENVIRONMENT_PRESET_MEDIUMROOM      -1000, -600, 0.0f, 1.30f, 0.83f, -1000, 0.010f,  -200, 0.020f, 100.0f, 100.0f, 5000.0f
2279 #define I3DL2_ENVIRONMENT_PRESET_LARGEROOM       -1000, -600, 0.0f, 1.50f, 0.83f, -1600, 0.020f, -1000, 0.040f, 100.0f, 100.0f, 5000.0f
2280 #define I3DL2_ENVIRONMENT_PRESET_MEDIUMHALL      -1000, -600, 0.0f, 1.80f, 0.70f, -1300, 0.015f,  -800, 0.030f, 100.0f, 100.0f, 5000.0f
2281 #define I3DL2_ENVIRONMENT_PRESET_LARGEHALL       -1000, -600, 0.0f, 1.80f, 0.70f, -2000, 0.030f, -1400, 0.060f, 100.0f, 100.0f, 5000.0f
2282 #define I3DL2_ENVIRONMENT_PRESET_PLATE           -1000, -200, 0.0f, 1.30f, 0.90f,     0, 0.002f,     0, 0.010f, 100.0f,  75.0f, 5000.0f
2283 
2284 //
2285 // DirectSound3D Algorithms
2286 //
2287 
2288 // Default DirectSound3D algorithm {00000000-0000-0000-0000-000000000000}
2289 #define DS3DALG_DEFAULT GUID_NULL
2290 
2291 // No virtualization (Pan3D) {C241333F-1C1B-11d2-94F5-00C04FC28ACA}
2292 DEFINE_GUID(DS3DALG_NO_VIRTUALIZATION, 0xc241333f, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2293 
2294 // High-quality HRTF algorithm {C2413340-1C1B-11d2-94F5-00C04FC28ACA}
2295 DEFINE_GUID(DS3DALG_HRTF_FULL, 0xc2413340, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2296 
2297 // Lower-quality HRTF algorithm {C2413342-1C1B-11d2-94F5-00C04FC28ACA}
2298 DEFINE_GUID(DS3DALG_HRTF_LIGHT, 0xc2413342, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2299 
2300 
2301 #if DIRECTSOUND_VERSION >= 0x0800
2302 
2303 //
2304 // DirectSound Internal Effect Algorithms
2305 //
2306 
2307 
2308 // Gargle {DAFD8210-5711-4B91-9FE3-F75B7AE279BF}
2309 DEFINE_GUID(GUID_DSFX_STANDARD_GARGLE, 0xdafd8210, 0x5711, 0x4b91, 0x9f, 0xe3, 0xf7, 0x5b, 0x7a, 0xe2, 0x79, 0xbf);
2310 
2311 // Chorus {EFE6629C-81F7-4281-BD91-C9D604A95AF6}
2312 DEFINE_GUID(GUID_DSFX_STANDARD_CHORUS, 0xefe6629c, 0x81f7, 0x4281, 0xbd, 0x91, 0xc9, 0xd6, 0x04, 0xa9, 0x5a, 0xf6);
2313 
2314 // Flanger {EFCA3D92-DFD8-4672-A603-7420894BAD98}
2315 DEFINE_GUID(GUID_DSFX_STANDARD_FLANGER, 0xefca3d92, 0xdfd8, 0x4672, 0xa6, 0x03, 0x74, 0x20, 0x89, 0x4b, 0xad, 0x98);
2316 
2317 // Echo/Delay {EF3E932C-D40B-4F51-8CCF-3F98F1B29D5D}
2318 DEFINE_GUID(GUID_DSFX_STANDARD_ECHO, 0xef3e932c, 0xd40b, 0x4f51, 0x8c, 0xcf, 0x3f, 0x98, 0xf1, 0xb2, 0x9d, 0x5d);
2319 
2320 // Distortion {EF114C90-CD1D-484E-96E5-09CFAF912A21}
2321 DEFINE_GUID(GUID_DSFX_STANDARD_DISTORTION, 0xef114c90, 0xcd1d, 0x484e, 0x96, 0xe5, 0x09, 0xcf, 0xaf, 0x91, 0x2a, 0x21);
2322 
2323 // Compressor/Limiter {EF011F79-4000-406D-87AF-BFFB3FC39D57}
2324 DEFINE_GUID(GUID_DSFX_STANDARD_COMPRESSOR, 0xef011f79, 0x4000, 0x406d, 0x87, 0xaf, 0xbf, 0xfb, 0x3f, 0xc3, 0x9d, 0x57);
2325 
2326 // Parametric Equalization {120CED89-3BF4-4173-A132-3CB406CF3231}
2327 DEFINE_GUID(GUID_DSFX_STANDARD_PARAMEQ, 0x120ced89, 0x3bf4, 0x4173, 0xa1, 0x32, 0x3c, 0xb4, 0x06, 0xcf, 0x32, 0x31);
2328 
2329 // I3DL2 Environmental Reverberation: Reverb (Listener) Effect {EF985E71-D5C7-42D4-BA4D-2D073E2E96F4}
2330 DEFINE_GUID(GUID_DSFX_STANDARD_I3DL2REVERB, 0xef985e71, 0xd5c7, 0x42d4, 0xba, 0x4d, 0x2d, 0x07, 0x3e, 0x2e, 0x96, 0xf4);
2331 
2332 // Waves Reverberation {87FC0268-9A55-4360-95AA-004A1D9DE26C}
2333 DEFINE_GUID(GUID_DSFX_WAVES_REVERB, 0x87fc0268, 0x9a55, 0x4360, 0x95, 0xaa, 0x00, 0x4a, 0x1d, 0x9d, 0xe2, 0x6c);
2334 
2335 //
2336 // DirectSound Capture Effect Algorithms
2337 //
2338 
2339 
2340 // Acoustic Echo Canceller {BF963D80-C559-11D0-8A2B-00A0C9255AC1}
2341 // Matches KSNODETYPE_ACOUSTIC_ECHO_CANCEL in ksmedia.h
2342 DEFINE_GUID(GUID_DSCFX_CLASS_AEC, 0xBF963D80L, 0xC559, 0x11D0, 0x8A, 0x2B, 0x00, 0xA0, 0xC9, 0x25, 0x5A, 0xC1);
2343 
2344 // Microsoft AEC {CDEBB919-379A-488a-8765-F53CFD36DE40}
2345 DEFINE_GUID(GUID_DSCFX_MS_AEC, 0xcdebb919, 0x379a, 0x488a, 0x87, 0x65, 0xf5, 0x3c, 0xfd, 0x36, 0xde, 0x40);
2346 
2347 // System AEC {1C22C56D-9879-4f5b-A389-27996DDC2810}
2348 DEFINE_GUID(GUID_DSCFX_SYSTEM_AEC, 0x1c22c56d, 0x9879, 0x4f5b, 0xa3, 0x89, 0x27, 0x99, 0x6d, 0xdc, 0x28, 0x10);
2349 
2350 // Noise Supression {E07F903F-62FD-4e60-8CDD-DEA7236665B5}
2351 // Matches KSNODETYPE_NOISE_SUPPRESS in post Windows ME DDK's ksmedia.h
2352 DEFINE_GUID(GUID_DSCFX_CLASS_NS, 0xe07f903f, 0x62fd, 0x4e60, 0x8c, 0xdd, 0xde, 0xa7, 0x23, 0x66, 0x65, 0xb5);
2353 
2354 // Microsoft Noise Suppresion {11C5C73B-66E9-4ba1-A0BA-E814C6EED92D}
2355 DEFINE_GUID(GUID_DSCFX_MS_NS, 0x11c5c73b, 0x66e9, 0x4ba1, 0xa0, 0xba, 0xe8, 0x14, 0xc6, 0xee, 0xd9, 0x2d);
2356 
2357 // System Noise Suppresion {5AB0882E-7274-4516-877D-4EEE99BA4FD0}
2358 DEFINE_GUID(GUID_DSCFX_SYSTEM_NS, 0x5ab0882e, 0x7274, 0x4516, 0x87, 0x7d, 0x4e, 0xee, 0x99, 0xba, 0x4f, 0xd0);
2359 
2360 #endif // DIRECTSOUND_VERSION >= 0x0800
2361 
2362 #endif // __DSOUND_INCLUDED__
2363 
2364 
2365 
2366 #ifdef __cplusplus
2367 };
2368 #endif // __cplusplus
2369 
2370