Subversion Repositories pentevo

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
1088 alone 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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
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
 
1973
// This object is already initialized
1974
#define DSERR_ALREADYINITIALIZED        MAKE_DSHRESULT(130)
1975
 
1976
// This object does not support aggregation
1977
#define DSERR_NOAGGREGATION             CLASS_E_NOAGGREGATION
1978
 
1979
// The buffer memory has been lost, and must be restored
1980
#define DSERR_BUFFERLOST                MAKE_DSHRESULT(150)
1981
 
1982
// Another app has a higher priority level, preventing this call from
1983
// succeeding
1984
#define DSERR_OTHERAPPHASPRIO           MAKE_DSHRESULT(160)
1985
 
1986
// This object has not been initialized
1987
#define DSERR_UNINITIALIZED             MAKE_DSHRESULT(170)
1988
 
1989
// The requested COM interface is not available
1990
#define DSERR_NOINTERFACE               E_NOINTERFACE
1991
 
1992
// Access is denied
1993
#define DSERR_ACCESSDENIED              E_ACCESSDENIED
1994
 
1995
// Tried to create a DSBCAPS_CTRLFX buffer shorter than DSBSIZE_FX_MIN milliseconds
1996
#define DSERR_BUFFERTOOSMALL            MAKE_DSHRESULT(180)
1997
 
1998
// Attempt to use DirectSound 8 functionality on an older DirectSound object
1999
#define DSERR_DS8_REQUIRED              MAKE_DSHRESULT(190)
2000
 
2001
// A circular loop of send effects was detected
2002
#define DSERR_SENDLOOP                  MAKE_DSHRESULT(200)
2003
 
2004
// The GUID specified in an audiopath file does not match a valid MIXIN buffer
2005
#define DSERR_BADSENDBUFFERGUID         MAKE_DSHRESULT(210)
2006
 
2007
// The object requested was not found (numerically equal to DMUS_E_NOT_FOUND)
2008
#define DSERR_OBJECTNOTFOUND            MAKE_DSHRESULT(4449)
2009
 
2010
// The effects requested could not be found on the system, or they were found
2011
// but in the wrong order, or in the wrong hardware/software locations.
2012
#define DSERR_FXUNAVAILABLE             MAKE_DSHRESULT(220)
2013
 
2014
//
2015
// Flags
2016
//
2017
 
2018
#define DSCAPS_PRIMARYMONO          0x00000001
2019
#define DSCAPS_PRIMARYSTEREO        0x00000002
2020
#define DSCAPS_PRIMARY8BIT          0x00000004
2021
#define DSCAPS_PRIMARY16BIT         0x00000008
2022
#define DSCAPS_CONTINUOUSRATE       0x00000010
2023
#define DSCAPS_EMULDRIVER           0x00000020
2024
#define DSCAPS_CERTIFIED            0x00000040
2025
#define DSCAPS_SECONDARYMONO        0x00000100
2026
#define DSCAPS_SECONDARYSTEREO      0x00000200
2027
#define DSCAPS_SECONDARY8BIT        0x00000400
2028
#define DSCAPS_SECONDARY16BIT       0x00000800
2029
 
2030
#define DSSCL_NORMAL                0x00000001
2031
#define DSSCL_PRIORITY              0x00000002
2032
#define DSSCL_EXCLUSIVE             0x00000003
2033
#define DSSCL_WRITEPRIMARY          0x00000004
2034
 
2035
#define DSSPEAKER_DIRECTOUT         0x00000000
2036
#define DSSPEAKER_HEADPHONE         0x00000001
2037
#define DSSPEAKER_MONO              0x00000002
2038
#define DSSPEAKER_QUAD              0x00000003
2039
#define DSSPEAKER_STEREO            0x00000004
2040
#define DSSPEAKER_SURROUND          0x00000005
2041
#define DSSPEAKER_5POINT1           0x00000006
2042
#define DSSPEAKER_7POINT1           0x00000007
2043
 
2044
#define DSSPEAKER_GEOMETRY_MIN      0x00000005  //   5 degrees
2045
#define DSSPEAKER_GEOMETRY_NARROW   0x0000000A  //  10 degrees
2046
#define DSSPEAKER_GEOMETRY_WIDE     0x00000014  //  20 degrees
2047
#define DSSPEAKER_GEOMETRY_MAX      0x000000B4  // 180 degrees
2048
 
2049
#define DSSPEAKER_COMBINED(c, g)    ((DWORD)(((BYTE)(c)) | ((DWORD)((BYTE)(g))) << 16))
2050
#define DSSPEAKER_CONFIG(a)         ((BYTE)(a))
2051
#define DSSPEAKER_GEOMETRY(a)       ((BYTE)(((DWORD)(a) >> 16) & 0x00FF))
2052
 
2053
#define DSBCAPS_PRIMARYBUFFER       0x00000001
2054
#define DSBCAPS_STATIC              0x00000002
2055
#define DSBCAPS_LOCHARDWARE         0x00000004
2056
#define DSBCAPS_LOCSOFTWARE         0x00000008
2057
#define DSBCAPS_CTRL3D              0x00000010
2058
#define DSBCAPS_CTRLFREQUENCY       0x00000020
2059
#define DSBCAPS_CTRLPAN             0x00000040
2060
#define DSBCAPS_CTRLVOLUME          0x00000080
2061
#define DSBCAPS_CTRLPOSITIONNOTIFY  0x00000100
2062
#define DSBCAPS_CTRLFX              0x00000200
2063
#define DSBCAPS_STICKYFOCUS         0x00004000
2064
#define DSBCAPS_GLOBALFOCUS         0x00008000
2065
#define DSBCAPS_GETCURRENTPOSITION2 0x00010000
2066
#define DSBCAPS_MUTE3DATMAXDISTANCE 0x00020000
2067
#define DSBCAPS_LOCDEFER            0x00040000
2068
 
2069
#define DSBPLAY_LOOPING             0x00000001
2070
#define DSBPLAY_LOCHARDWARE         0x00000002
2071
#define DSBPLAY_LOCSOFTWARE         0x00000004
2072
#define DSBPLAY_TERMINATEBY_TIME    0x00000008
2073
#define DSBPLAY_TERMINATEBY_DISTANCE    0x000000010
2074
#define DSBPLAY_TERMINATEBY_PRIORITY    0x000000020
2075
 
2076
#define DSBSTATUS_PLAYING           0x00000001
2077
#define DSBSTATUS_BUFFERLOST        0x00000002
2078
#define DSBSTATUS_LOOPING           0x00000004
2079
#define DSBSTATUS_LOCHARDWARE       0x00000008
2080
#define DSBSTATUS_LOCSOFTWARE       0x00000010
2081
#define DSBSTATUS_TERMINATED        0x00000020
2082
 
2083
#define DSBLOCK_FROMWRITECURSOR     0x00000001
2084
#define DSBLOCK_ENTIREBUFFER        0x00000002
2085
 
2086
#define DSBFREQUENCY_ORIGINAL       0
2087
#define DSBFREQUENCY_MIN            100
2088
#if DIRECTSOUND_VERSION >= 0x0900
2089
#define DSBFREQUENCY_MAX            200000
2090
#else
2091
#define DSBFREQUENCY_MAX            100000
2092
#endif
2093
 
2094
#define DSBPAN_LEFT                 -10000
2095
#define DSBPAN_CENTER               0
2096
#define DSBPAN_RIGHT                10000
2097
 
2098
#define DSBVOLUME_MIN               -10000
2099
#define DSBVOLUME_MAX               0
2100
 
2101
#define DSBSIZE_MIN                 4
2102
#define DSBSIZE_MAX                 0x0FFFFFFF
2103
#define DSBSIZE_FX_MIN              150  // NOTE: Milliseconds, not bytes
2104
 
2105
#define DS3DMODE_NORMAL             0x00000000
2106
#define DS3DMODE_HEADRELATIVE       0x00000001
2107
#define DS3DMODE_DISABLE            0x00000002
2108
 
2109
#define DS3D_IMMEDIATE              0x00000000
2110
#define DS3D_DEFERRED               0x00000001
2111
 
2112
#define DS3D_MINDISTANCEFACTOR      FLT_MIN
2113
#define DS3D_MAXDISTANCEFACTOR      FLT_MAX
2114
#define DS3D_DEFAULTDISTANCEFACTOR  1.0f
2115
 
2116
#define DS3D_MINROLLOFFFACTOR       0.0f
2117
#define DS3D_MAXROLLOFFFACTOR       10.0f
2118
#define DS3D_DEFAULTROLLOFFFACTOR   1.0f
2119
 
2120
#define DS3D_MINDOPPLERFACTOR       0.0f
2121
#define DS3D_MAXDOPPLERFACTOR       10.0f
2122
#define DS3D_DEFAULTDOPPLERFACTOR   1.0f
2123
 
2124
#define DS3D_DEFAULTMINDISTANCE     1.0f
2125
#define DS3D_DEFAULTMAXDISTANCE     1000000000.0f
2126
 
2127
#define DS3D_MINCONEANGLE           0
2128
#define DS3D_MAXCONEANGLE           360
2129
#define DS3D_DEFAULTCONEANGLE       360
2130
 
2131
#define DS3D_DEFAULTCONEOUTSIDEVOLUME DSBVOLUME_MAX
2132
 
2133
// IDirectSoundCapture attributes
2134
 
2135
#define DSCCAPS_EMULDRIVER          DSCAPS_EMULDRIVER
2136
#define DSCCAPS_CERTIFIED           DSCAPS_CERTIFIED
2137
#define DSCCAPS_MULTIPLECAPTURE     0x00000001
2138
 
2139
// IDirectSoundCaptureBuffer attributes
2140
 
2141
#define DSCBCAPS_WAVEMAPPED         0x80000000
2142
 
2143
#if DIRECTSOUND_VERSION >= 0x0800
2144
#define DSCBCAPS_CTRLFX             0x00000200
2145
#endif
2146
 
2147
 
2148
#define DSCBLOCK_ENTIREBUFFER       0x00000001
2149
 
2150
#define DSCBSTATUS_CAPTURING        0x00000001
2151
#define DSCBSTATUS_LOOPING          0x00000002
2152
 
2153
#define DSCBSTART_LOOPING           0x00000001
2154
 
2155
#define DSBPN_OFFSETSTOP            0xFFFFFFFF
2156
 
2157
#define DS_CERTIFIED                0x00000000
2158
#define DS_UNCERTIFIED              0x00000001
2159
 
2160
 
2161
//
2162
// Flags for the I3DL2 effects
2163
//
2164
 
2165
//
2166
// I3DL2 Material Presets
2167
//
2168
 
2169
enum
2170
{
2171
    DSFX_I3DL2_MATERIAL_PRESET_SINGLEWINDOW,
2172
    DSFX_I3DL2_MATERIAL_PRESET_DOUBLEWINDOW,
2173
    DSFX_I3DL2_MATERIAL_PRESET_THINDOOR,
2174
    DSFX_I3DL2_MATERIAL_PRESET_THICKDOOR,
2175
    DSFX_I3DL2_MATERIAL_PRESET_WOODWALL,
2176
    DSFX_I3DL2_MATERIAL_PRESET_BRICKWALL,
2177
    DSFX_I3DL2_MATERIAL_PRESET_STONEWALL,
2178
    DSFX_I3DL2_MATERIAL_PRESET_CURTAIN
2179
};
2180
 
2181
#define I3DL2_MATERIAL_PRESET_SINGLEWINDOW    -2800,0.71f
2182
#define I3DL2_MATERIAL_PRESET_DOUBLEWINDOW    -5000,0.40f
2183
#define I3DL2_MATERIAL_PRESET_THINDOOR        -1800,0.66f
2184
#define I3DL2_MATERIAL_PRESET_THICKDOOR       -4400,0.64f
2185
#define I3DL2_MATERIAL_PRESET_WOODWALL        -4000,0.50f
2186
#define I3DL2_MATERIAL_PRESET_BRICKWALL       -5000,0.60f
2187
#define I3DL2_MATERIAL_PRESET_STONEWALL       -6000,0.68f
2188
#define I3DL2_MATERIAL_PRESET_CURTAIN         -1200,0.15f
2189
 
2190
enum
2191
{
2192
    DSFX_I3DL2_ENVIRONMENT_PRESET_DEFAULT,
2193
    DSFX_I3DL2_ENVIRONMENT_PRESET_GENERIC,
2194
    DSFX_I3DL2_ENVIRONMENT_PRESET_PADDEDCELL,
2195
    DSFX_I3DL2_ENVIRONMENT_PRESET_ROOM,
2196
    DSFX_I3DL2_ENVIRONMENT_PRESET_BATHROOM,
2197
    DSFX_I3DL2_ENVIRONMENT_PRESET_LIVINGROOM,
2198
    DSFX_I3DL2_ENVIRONMENT_PRESET_STONEROOM,
2199
    DSFX_I3DL2_ENVIRONMENT_PRESET_AUDITORIUM,
2200
    DSFX_I3DL2_ENVIRONMENT_PRESET_CONCERTHALL,
2201
    DSFX_I3DL2_ENVIRONMENT_PRESET_CAVE,
2202
    DSFX_I3DL2_ENVIRONMENT_PRESET_ARENA,
2203
    DSFX_I3DL2_ENVIRONMENT_PRESET_HANGAR,
2204
    DSFX_I3DL2_ENVIRONMENT_PRESET_CARPETEDHALLWAY,
2205
    DSFX_I3DL2_ENVIRONMENT_PRESET_HALLWAY,
2206
    DSFX_I3DL2_ENVIRONMENT_PRESET_STONECORRIDOR,
2207
    DSFX_I3DL2_ENVIRONMENT_PRESET_ALLEY,
2208
    DSFX_I3DL2_ENVIRONMENT_PRESET_FOREST,
2209
    DSFX_I3DL2_ENVIRONMENT_PRESET_CITY,
2210
    DSFX_I3DL2_ENVIRONMENT_PRESET_MOUNTAINS,
2211
    DSFX_I3DL2_ENVIRONMENT_PRESET_QUARRY,
2212
    DSFX_I3DL2_ENVIRONMENT_PRESET_PLAIN,
2213
    DSFX_I3DL2_ENVIRONMENT_PRESET_PARKINGLOT,
2214
    DSFX_I3DL2_ENVIRONMENT_PRESET_SEWERPIPE,
2215
    DSFX_I3DL2_ENVIRONMENT_PRESET_UNDERWATER,
2216
    DSFX_I3DL2_ENVIRONMENT_PRESET_SMALLROOM,
2217
    DSFX_I3DL2_ENVIRONMENT_PRESET_MEDIUMROOM,
2218
    DSFX_I3DL2_ENVIRONMENT_PRESET_LARGEROOM,
2219
    DSFX_I3DL2_ENVIRONMENT_PRESET_MEDIUMHALL,
2220
    DSFX_I3DL2_ENVIRONMENT_PRESET_LARGEHALL,
2221
    DSFX_I3DL2_ENVIRONMENT_PRESET_PLATE
2222
};
2223
 
2224
//
2225
// I3DL2 Reverberation Presets Values
2226
//
2227
 
2228
#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
2229
#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
2230
#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
2231
#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
2232
#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
2233
#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
2234
#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
2235
#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
2236
#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
2237
#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
2238
#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
2239
#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
2240
#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
2241
#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
2242
#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
2243
#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
2244
#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
2245
#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
2246
#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
2247
#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
2248
#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
2249
#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
2250
#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
2251
#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
2252
 
2253
//
2254
// Examples simulating 'musical' reverb presets
2255
//
2256
// Name       Decay time   Description
2257
// Small Room    1.1s      A small size room with a length of 5m or so.
2258
// Medium Room   1.3s      A medium size room with a length of 10m or so.
2259
// Large Room    1.5s      A large size room suitable for live performances.
2260
// Medium Hall   1.8s      A medium size concert hall.
2261
// Large Hall    1.8s      A large size concert hall suitable for a full orchestra.
2262
// Plate         1.3s      A plate reverb simulation.
2263
//
2264
 
2265
#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
2266
#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
2267
#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
2268
#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
2269
#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
2270
#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
2271
 
2272
//
2273
// DirectSound3D Algorithms
2274
//
2275
 
2276
// Default DirectSound3D algorithm {00000000-0000-0000-0000-000000000000}
2277
#define DS3DALG_DEFAULT GUID_NULL
2278
 
2279
// No virtualization (Pan3D) {C241333F-1C1B-11d2-94F5-00C04FC28ACA}
2280
DEFINE_GUID(DS3DALG_NO_VIRTUALIZATION, 0xc241333f, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2281
 
2282
// High-quality HRTF algorithm {C2413340-1C1B-11d2-94F5-00C04FC28ACA}
2283
DEFINE_GUID(DS3DALG_HRTF_FULL, 0xc2413340, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2284
 
2285
// Lower-quality HRTF algorithm {C2413342-1C1B-11d2-94F5-00C04FC28ACA}
2286
DEFINE_GUID(DS3DALG_HRTF_LIGHT, 0xc2413342, 0x1c1b, 0x11d2, 0x94, 0xf5, 0x0, 0xc0, 0x4f, 0xc2, 0x8a, 0xca);
2287
 
2288
 
2289
#if DIRECTSOUND_VERSION >= 0x0800
2290
 
2291
//
2292
// DirectSound Internal Effect Algorithms
2293
//
2294
 
2295
 
2296
// Gargle {DAFD8210-5711-4B91-9FE3-F75B7AE279BF}
2297
DEFINE_GUID(GUID_DSFX_STANDARD_GARGLE, 0xdafd8210, 0x5711, 0x4b91, 0x9f, 0xe3, 0xf7, 0x5b, 0x7a, 0xe2, 0x79, 0xbf);
2298
 
2299
// Chorus {EFE6629C-81F7-4281-BD91-C9D604A95AF6}
2300
DEFINE_GUID(GUID_DSFX_STANDARD_CHORUS, 0xefe6629c, 0x81f7, 0x4281, 0xbd, 0x91, 0xc9, 0xd6, 0x04, 0xa9, 0x5a, 0xf6);
2301
 
2302
// Flanger {EFCA3D92-DFD8-4672-A603-7420894BAD98}
2303
DEFINE_GUID(GUID_DSFX_STANDARD_FLANGER, 0xefca3d92, 0xdfd8, 0x4672, 0xa6, 0x03, 0x74, 0x20, 0x89, 0x4b, 0xad, 0x98);
2304
 
2305
// Echo/Delay {EF3E932C-D40B-4F51-8CCF-3F98F1B29D5D}
2306
DEFINE_GUID(GUID_DSFX_STANDARD_ECHO, 0xef3e932c, 0xd40b, 0x4f51, 0x8c, 0xcf, 0x3f, 0x98, 0xf1, 0xb2, 0x9d, 0x5d);
2307
 
2308
// Distortion {EF114C90-CD1D-484E-96E5-09CFAF912A21}
2309
DEFINE_GUID(GUID_DSFX_STANDARD_DISTORTION, 0xef114c90, 0xcd1d, 0x484e, 0x96, 0xe5, 0x09, 0xcf, 0xaf, 0x91, 0x2a, 0x21);
2310
 
2311
// Compressor/Limiter {EF011F79-4000-406D-87AF-BFFB3FC39D57}
2312
DEFINE_GUID(GUID_DSFX_STANDARD_COMPRESSOR, 0xef011f79, 0x4000, 0x406d, 0x87, 0xaf, 0xbf, 0xfb, 0x3f, 0xc3, 0x9d, 0x57);
2313
 
2314
// Parametric Equalization {120CED89-3BF4-4173-A132-3CB406CF3231}
2315
DEFINE_GUID(GUID_DSFX_STANDARD_PARAMEQ, 0x120ced89, 0x3bf4, 0x4173, 0xa1, 0x32, 0x3c, 0xb4, 0x06, 0xcf, 0x32, 0x31);
2316
 
2317
// I3DL2 Environmental Reverberation: Reverb (Listener) Effect {EF985E71-D5C7-42D4-BA4D-2D073E2E96F4}
2318
DEFINE_GUID(GUID_DSFX_STANDARD_I3DL2REVERB, 0xef985e71, 0xd5c7, 0x42d4, 0xba, 0x4d, 0x2d, 0x07, 0x3e, 0x2e, 0x96, 0xf4);
2319
 
2320
// Waves Reverberation {87FC0268-9A55-4360-95AA-004A1D9DE26C}
2321
DEFINE_GUID(GUID_DSFX_WAVES_REVERB, 0x87fc0268, 0x9a55, 0x4360, 0x95, 0xaa, 0x00, 0x4a, 0x1d, 0x9d, 0xe2, 0x6c);
2322
 
2323
//
2324
// DirectSound Capture Effect Algorithms
2325
//
2326
 
2327
 
2328
// Acoustic Echo Canceller {BF963D80-C559-11D0-8A2B-00A0C9255AC1}
2329
// Matches KSNODETYPE_ACOUSTIC_ECHO_CANCEL in ksmedia.h
2330
DEFINE_GUID(GUID_DSCFX_CLASS_AEC, 0xBF963D80L, 0xC559, 0x11D0, 0x8A, 0x2B, 0x00, 0xA0, 0xC9, 0x25, 0x5A, 0xC1);
2331
 
2332
// Microsoft AEC {CDEBB919-379A-488a-8765-F53CFD36DE40}
2333
DEFINE_GUID(GUID_DSCFX_MS_AEC, 0xcdebb919, 0x379a, 0x488a, 0x87, 0x65, 0xf5, 0x3c, 0xfd, 0x36, 0xde, 0x40);
2334
 
2335
// System AEC {1C22C56D-9879-4f5b-A389-27996DDC2810}
2336
DEFINE_GUID(GUID_DSCFX_SYSTEM_AEC, 0x1c22c56d, 0x9879, 0x4f5b, 0xa3, 0x89, 0x27, 0x99, 0x6d, 0xdc, 0x28, 0x10);
2337
 
2338
// Noise Supression {E07F903F-62FD-4e60-8CDD-DEA7236665B5}
2339
// Matches KSNODETYPE_NOISE_SUPPRESS in post Windows ME DDK's ksmedia.h
2340
DEFINE_GUID(GUID_DSCFX_CLASS_NS, 0xe07f903f, 0x62fd, 0x4e60, 0x8c, 0xdd, 0xde, 0xa7, 0x23, 0x66, 0x65, 0xb5);
2341
 
2342
// Microsoft Noise Suppresion {11C5C73B-66E9-4ba1-A0BA-E814C6EED92D}
2343
DEFINE_GUID(GUID_DSCFX_MS_NS, 0x11c5c73b, 0x66e9, 0x4ba1, 0xa0, 0xba, 0xe8, 0x14, 0xc6, 0xee, 0xd9, 0x2d);
2344
 
2345
// System Noise Suppresion {5AB0882E-7274-4516-877D-4EEE99BA4FD0}
2346
DEFINE_GUID(GUID_DSCFX_SYSTEM_NS, 0x5ab0882e, 0x7274, 0x4516, 0x87, 0x7d, 0x4e, 0xee, 0x99, 0xba, 0x4f, 0xd0);
2347
 
2348
#endif // DIRECTSOUND_VERSION >= 0x0800
2349
 
2350
#endif // __DSOUND_INCLUDED__
2351
 
2352
 
2353
 
2354
#ifdef __cplusplus
2355
};
2356
#endif // __cplusplus
2357
 
2358