Mercurial > mm7

comparison lib/legacy_dx/dmusicc.h @ 0:9c0607679772

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
init
author Ritor1
date Sat, 12 Jan 2013 09:45:18 +0600
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:9c0607679772
1 /************************************************************************
2 * *
3 * dmusicc.h -- This module defines the DirectMusic core API's *
4 * *
5 * Copyright (c) Microsoft Corporation. All rights reserved. *
6 * *
7 ************************************************************************/
8
9 #ifndef _DMUSICC_
10 #define _DMUSICC_
11
12 #include <windows.h>
13
14 #define COM_NO_WINDOWS_H
15 #include <objbase.h>
16
17 #include <mmsystem.h>
18
19 #include "dls1.h"
20 #include "dmerror.h"
21 #include "dmdls.h"
22 #include "dsound.h"
23 #include "dmusbuff.h"
24
25 #include <pshpack8.h>
26
27 #ifdef __cplusplus
28 extern "C" {
29 #endif
30
31 typedef ULONGLONG SAMPLE_TIME;
32 typedef ULONGLONG SAMPLE_POSITION;
33 typedef SAMPLE_TIME *LPSAMPLE_TIME;
34
35 #define DMUS_MAX_DESCRIPTION 128
36 #define DMUS_MAX_DRIVER 128
37
38 typedef struct _DMUS_BUFFERDESC *LPDMUS_BUFFERDESC;
39 typedef struct _DMUS_BUFFERDESC
40 {
41 DWORD dwSize;
42 DWORD dwFlags;
43 GUID guidBufferFormat;
44 DWORD cbBuffer;
45 } DMUS_BUFFERDESC;
46
47 /* DMUS_EFFECT_ flags are used in the dwEffectFlags fields of both DMUS_PORTCAPS
48 * and DMUS_PORTPARAMS.
49 */
50 #define DMUS_EFFECT_NONE 0x00000000
51 #define DMUS_EFFECT_REVERB 0x00000001
52 #define DMUS_EFFECT_CHORUS 0x00000002
53 #define DMUS_EFFECT_DELAY 0x00000004
54
55 /* For DMUS_PORTCAPS dwClass
56 */
57 #define DMUS_PC_INPUTCLASS (0)
58 #define DMUS_PC_OUTPUTCLASS (1)
59
60 /* For DMUS_PORTCAPS dwFlags
61 */
62 #define DMUS_PC_DLS (0x00000001) // Supports DLS downloading and DLS level 1.
63 #define DMUS_PC_EXTERNAL (0x00000002) // External MIDI module.
64 #define DMUS_PC_SOFTWARESYNTH (0x00000004) // Software synthesizer.
65 #define DMUS_PC_MEMORYSIZEFIXED (0x00000008) // Memory size is fixed.
66 #define DMUS_PC_GMINHARDWARE (0x00000010) // GM sound set is built in, no need to download.
67 #define DMUS_PC_GSINHARDWARE (0x00000020) // GS sound set is built in.
68 #define DMUS_PC_XGINHARDWARE (0x00000040) // XG sound set is built in.
69 #define DMUS_PC_DIRECTSOUND (0x00000080) // Connects to DirectSound via a DirectSound buffer.
70 #define DMUS_PC_SHAREABLE (0x00000100) // Synth can be actively shared by multiple apps at once.
71 #define DMUS_PC_DLS2 (0x00000200) // Supports DLS2 instruments.
72 #define DMUS_PC_AUDIOPATH (0x00000400) // Multiple outputs can be connected to DirectSound for audiopaths.
73 #define DMUS_PC_WAVE (0x00000800) // Supports streaming and one shot waves.
74
75 #define DMUS_PC_SYSTEMMEMORY (0x7FFFFFFF) // Sample memory is system memory.
76
77
78 typedef struct _DMUS_PORTCAPS
79 {
80 DWORD dwSize;
81 DWORD dwFlags;
82 GUID guidPort;
83 DWORD dwClass;
84 DWORD dwType;
85 DWORD dwMemorySize;
86 DWORD dwMaxChannelGroups;
87 DWORD dwMaxVoices;
88 DWORD dwMaxAudioChannels;
89 DWORD dwEffectFlags;
90 WCHAR wszDescription[DMUS_MAX_DESCRIPTION];
91 } DMUS_PORTCAPS;
92
93 typedef DMUS_PORTCAPS *LPDMUS_PORTCAPS;
94
95 /* Values for DMUS_PORTCAPS dwType. This field indicates the underlying
96 * driver type of the port.
97 */
98 #define DMUS_PORT_WINMM_DRIVER (0)
99 #define DMUS_PORT_USER_MODE_SYNTH (1)
100 #define DMUS_PORT_KERNEL_MODE (2)
101
102 /* These flags (set in dwValidParams) indicate which other members of the */
103 /* DMUS_PORTPARAMS are valid. */
104 /* */
105 #define DMUS_PORTPARAMS_VOICES 0x00000001
106 #define DMUS_PORTPARAMS_CHANNELGROUPS 0x00000002
107 #define DMUS_PORTPARAMS_AUDIOCHANNELS 0x00000004
108 #define DMUS_PORTPARAMS_SAMPLERATE 0x00000008
109 #define DMUS_PORTPARAMS_EFFECTS 0x00000020
110 #define DMUS_PORTPARAMS_SHARE 0x00000040
111 #define DMUS_PORTPARAMS_FEATURES 0x00000080 /* DirectX 8.0 and above */
112
113 typedef struct _DMUS_PORTPARAMS
114 {
115 DWORD dwSize;
116 DWORD dwValidParams;
117 DWORD dwVoices;
118 DWORD dwChannelGroups;
119 DWORD dwAudioChannels;
120 DWORD dwSampleRate;
121 DWORD dwEffectFlags;
122 BOOL fShare;
123 } DMUS_PORTPARAMS7;
124
125 typedef struct _DMUS_PORTPARAMS8
126 {
127 DWORD dwSize;
128 DWORD dwValidParams;
129 DWORD dwVoices;
130 DWORD dwChannelGroups;
131 DWORD dwAudioChannels;
132 DWORD dwSampleRate;
133 DWORD dwEffectFlags;
134 BOOL fShare;
135 DWORD dwFeatures;
136 } DMUS_PORTPARAMS8;
137
138 #define DMUS_PORT_FEATURE_AUDIOPATH 0x00000001 /* Supports audiopath connection to DirectSound buffers. */
139 #define DMUS_PORT_FEATURE_STREAMING 0x00000002 /* Supports streaming waves through the synth. */
140
141
142 typedef DMUS_PORTPARAMS8 DMUS_PORTPARAMS;
143 typedef DMUS_PORTPARAMS *LPDMUS_PORTPARAMS;
144
145 typedef struct _DMUS_SYNTHSTATS *LPDMUS_SYNTHSTATS;
146 typedef struct _DMUS_SYNTHSTATS8 *LPDMUS_SYNTHSTATS8;
147 typedef struct _DMUS_SYNTHSTATS
148 {
149 DWORD dwSize; /* Size in bytes of the structure */
150 DWORD dwValidStats; /* Flags indicating which fields below are valid. */
151 DWORD dwVoices; /* Average number of voices playing. */
152 DWORD dwTotalCPU; /* Total CPU usage as percent * 100. */
153 DWORD dwCPUPerVoice; /* CPU per voice as percent * 100. */
154 DWORD dwLostNotes; /* Number of notes lost in 1 second. */
155 DWORD dwFreeMemory; /* Free memory in bytes */
156 long lPeakVolume; /* Decibel level * 100. */
157 } DMUS_SYNTHSTATS;
158
159 typedef struct _DMUS_SYNTHSTATS8
160 {
161 DWORD dwSize; /* Size in bytes of the structure */
162 DWORD dwValidStats; /* Flags indicating which fields below are valid. */
163 DWORD dwVoices; /* Average number of voices playing. */
164 DWORD dwTotalCPU; /* Total CPU usage as percent * 100. */
165 DWORD dwCPUPerVoice; /* CPU per voice as percent * 100. */
166 DWORD dwLostNotes; /* Number of notes lost in 1 second. */
167 DWORD dwFreeMemory; /* Free memory in bytes */
168 long lPeakVolume; /* Decibel level * 100. */
169 DWORD dwSynthMemUse; /* Memory used by synth wave data */
170 } DMUS_SYNTHSTATS8;
171
172 #define DMUS_SYNTHSTATS_VOICES (1 << 0)
173 #define DMUS_SYNTHSTATS_TOTAL_CPU (1 << 1)
174 #define DMUS_SYNTHSTATS_CPU_PER_VOICE (1 << 2)
175 #define DMUS_SYNTHSTATS_LOST_NOTES (1 << 3)
176 #define DMUS_SYNTHSTATS_PEAK_VOLUME (1 << 4)
177 #define DMUS_SYNTHSTATS_FREE_MEMORY (1 << 5)
178
179 #define DMUS_SYNTHSTATS_SYSTEMMEMORY DMUS_PC_SYSTEMMEMORY
180
181 typedef struct _DMUS_WAVES_REVERB_PARAMS
182 {
183 float fInGain; /* Input gain in dB (to avoid output overflows) */
184 float fReverbMix; /* Reverb mix in dB. 0dB means 100% wet reverb (no direct signal)
185 Negative values gives less wet signal.
186 The coeficients are calculated so that the overall output level stays
187 (approximately) constant regardless of the ammount of reverb mix. */
188 float fReverbTime; /* The reverb decay time, in milliseconds. */
189 float fHighFreqRTRatio; /* The ratio of the high frequencies to the global reverb time.
190 Unless very 'splashy-bright' reverbs are wanted, this should be set to
191 a value < 1.0.
192 For example if dRevTime==1000ms and dHighFreqRTRatio=0.1 than the
193 decay time for high frequencies will be 100ms.*/
194
195 } DMUS_WAVES_REVERB_PARAMS;
196
197 /* Note: Default values for Reverb are:
198 fInGain = 0.0dB (no change in level)
199 fReverbMix = -10.0dB (a reasonable reverb mix)
200 fReverbTime = 1000.0ms (one second global reverb time)
201 fHighFreqRTRatio = 0.001 (the ratio of the high frequencies to the global reverb time)
202 */
203
204 typedef enum
205 {
206 DMUS_CLOCK_SYSTEM = 0,
207 DMUS_CLOCK_WAVE = 1
208 } DMUS_CLOCKTYPE;
209
210 #define DMUS_CLOCKF_GLOBAL 0x00000001
211
212 typedef struct _DMUS_CLOCKINFO7 *LPDMUS_CLOCKINFO7;
213 typedef struct _DMUS_CLOCKINFO7
214 {
215 DWORD dwSize;
216 DMUS_CLOCKTYPE ctType;
217 GUID guidClock; /* Identifies this time source */
218 WCHAR wszDescription[DMUS_MAX_DESCRIPTION];
219 } DMUS_CLOCKINFO7;
220
221 typedef struct _DMUS_CLOCKINFO8 *LPDMUS_CLOCKINFO8;
222 typedef struct _DMUS_CLOCKINFO8
223 {
224 DWORD dwSize;
225 DMUS_CLOCKTYPE ctType;
226 GUID guidClock; /* Identifies this time source */
227 WCHAR wszDescription[DMUS_MAX_DESCRIPTION];
228 DWORD dwFlags;
229 } DMUS_CLOCKINFO8;
230
231 typedef DMUS_CLOCKINFO8 DMUS_CLOCKINFO;
232 typedef DMUS_CLOCKINFO *LPDMUS_CLOCKINFO;
233
234 /* Default bus identifiers
235 *
236 * The first 17 are direct mappings to the destinations defined in both
237 * the MMA DLS Level 2 specification and the Microsoft Multi-Channel audio
238 * specification.
239 */
240 #define DSBUSID_FIRST_SPKR_LOC 0
241 #define DSBUSID_FRONT_LEFT 0
242 #define DSBUSID_LEFT 0 /* Front left is also just left */
243 #define DSBUSID_FRONT_RIGHT 1
244 #define DSBUSID_RIGHT 1 /* Ditto front right */
245 #define DSBUSID_FRONT_CENTER 2
246 #define DSBUSID_LOW_FREQUENCY 3
247 #define DSBUSID_BACK_LEFT 4
248 #define DSBUSID_BACK_RIGHT 5
249 #define DSBUSID_FRONT_LEFT_OF_CENTER 6
250 #define DSBUSID_FRONT_RIGHT_OF_CENTER 7
251 #define DSBUSID_BACK_CENTER 8
252 #define DSBUSID_SIDE_LEFT 9
253 #define DSBUSID_SIDE_RIGHT 10
254 #define DSBUSID_TOP_CENTER 11
255 #define DSBUSID_TOP_FRONT_LEFT 12
256 #define DSBUSID_TOP_FRONT_CENTER 13
257 #define DSBUSID_TOP_FRONT_RIGHT 14
258 #define DSBUSID_TOP_BACK_LEFT 15
259 #define DSBUSID_TOP_BACK_CENTER 16
260 #define DSBUSID_TOP_BACK_RIGHT 17
261 #define DSBUSID_LAST_SPKR_LOC 17
262
263 #define DSBUSID_IS_SPKR_LOC(id) ( ((id) >= DSBUSID_FIRST_SPKR_LOC) && ((id) <= DSBUSID_LAST_SPKR_LOC) )
264
265 /* These bus identifiers are for the standard DLS effect sends
266 */
267 #define DSBUSID_REVERB_SEND 64
268 #define DSBUSID_CHORUS_SEND 65
269
270 /* Dynamic bus identifiers start here. See the documentation for how
271 * synthesizers map the output of voices to static and dynamic
272 * bus identifiers.
273 */
274 #define DSBUSID_DYNAMIC_0 512
275
276 /* Null bus, used to identify busses that have no function mapping.
277 */
278 #define DSBUSID_NULL 0xFFFFFFFF
279
280 interface IDirectMusic;
281 interface IDirectMusic8;
282 interface IDirectMusicBuffer;
283 interface IDirectMusicPort;
284 interface IDirectMusicThru;
285 interface IReferenceClock;
286
287 #ifndef __cplusplus
288
289 typedef interface IDirectMusic IDirectMusic;
290 typedef interface IDirectMusic8 IDirectMusic8;
291 typedef interface IDirectMusicPort IDirectMusicPort;
292 typedef interface IDirectMusicBuffer IDirectMusicBuffer;
293 typedef interface IDirectMusicThru IDirectMusicThru;
294 typedef interface IReferenceClock IReferenceClock;
295
296 #endif /* C++ */
297
298 typedef IDirectMusic *LPDIRECTMUSIC;
299 typedef IDirectMusic8 *LPDIRECTMUSIC8;
300 typedef IDirectMusicPort *LPDIRECTMUSICPORT;
301 typedef IDirectMusicBuffer *LPDIRECTMUSICBUFFER;
302
303 #undef INTERFACE
304 #define INTERFACE IDirectMusic
305 DECLARE_INTERFACE_(IDirectMusic, IUnknown)
306 {
307 /* IUnknown */
308 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
309 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
310 STDMETHOD_(ULONG,Release) (THIS) PURE;
311
312 /* IDirectMusic */
313 STDMETHOD(EnumPort) (THIS_ DWORD dwIndex,
314 LPDMUS_PORTCAPS pPortCaps) PURE;
315 STDMETHOD(CreateMusicBuffer) (THIS_ LPDMUS_BUFFERDESC pBufferDesc,
316 LPDIRECTMUSICBUFFER *ppBuffer,
317 LPUNKNOWN pUnkOuter) PURE;
318 STDMETHOD(CreatePort) (THIS_ REFCLSID rclsidPort,
319 LPDMUS_PORTPARAMS pPortParams,
320 LPDIRECTMUSICPORT *ppPort,
321 LPUNKNOWN pUnkOuter) PURE;
322 STDMETHOD(EnumMasterClock) (THIS_ DWORD dwIndex,
323 LPDMUS_CLOCKINFO lpClockInfo) PURE;
324 STDMETHOD(GetMasterClock) (THIS_ LPGUID pguidClock,
325 IReferenceClock **ppReferenceClock) PURE;
326 STDMETHOD(SetMasterClock) (THIS_ REFGUID rguidClock) PURE;
327 STDMETHOD(Activate) (THIS_ BOOL fEnable) PURE;
328 STDMETHOD(GetDefaultPort) (THIS_ LPGUID pguidPort) PURE;
329 STDMETHOD(SetDirectSound) (THIS_ LPDIRECTSOUND pDirectSound,
330 HWND hWnd) PURE;
331 };
332
333 #undef INTERFACE
334 #define INTERFACE IDirectMusic8
335 DECLARE_INTERFACE_(IDirectMusic8, IDirectMusic)
336 {
337 /* IUnknown */
338 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
339 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
340 STDMETHOD_(ULONG,Release) (THIS) PURE;
341
342 /* IDirectMusic */
343 STDMETHOD(EnumPort) (THIS_ DWORD dwIndex,
344 LPDMUS_PORTCAPS pPortCaps) PURE;
345 STDMETHOD(CreateMusicBuffer) (THIS_ LPDMUS_BUFFERDESC pBufferDesc,
346 LPDIRECTMUSICBUFFER *ppBuffer,
347 LPUNKNOWN pUnkOuter) PURE;
348 STDMETHOD(CreatePort) (THIS_ REFCLSID rclsidPort,
349 LPDMUS_PORTPARAMS pPortParams,
350 LPDIRECTMUSICPORT *ppPort,
351 LPUNKNOWN pUnkOuter) PURE;
352 STDMETHOD(EnumMasterClock) (THIS_ DWORD dwIndex,
353 LPDMUS_CLOCKINFO lpClockInfo) PURE;
354 STDMETHOD(GetMasterClock) (THIS_ LPGUID pguidClock,
355 IReferenceClock **ppReferenceClock) PURE;
356 STDMETHOD(SetMasterClock) (THIS_ REFGUID rguidClock) PURE;
357 STDMETHOD(Activate) (THIS_ BOOL fEnable) PURE;
358 STDMETHOD(GetDefaultPort) (THIS_ LPGUID pguidPort) PURE;
359 STDMETHOD(SetDirectSound) (THIS_ LPDIRECTSOUND pDirectSound,
360 HWND hWnd) PURE;
361 /* IDirectMusic8 */
362 STDMETHOD(SetExternalMasterClock)
363 (THIS_ IReferenceClock *pClock) PURE;
364 };
365
366 #undef INTERFACE
367 #define INTERFACE IDirectMusicBuffer
368 DECLARE_INTERFACE_(IDirectMusicBuffer, IUnknown)
369 {
370 /* IUnknown */
371 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
372 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
373 STDMETHOD_(ULONG,Release) (THIS) PURE;
374
375 /* IDirectMusicBuffer */
376 STDMETHOD(Flush) (THIS) PURE;
377 STDMETHOD(TotalTime) (THIS_ LPREFERENCE_TIME prtTime) PURE;
378
379 STDMETHOD(PackStructured) (THIS_ REFERENCE_TIME rt,
380 DWORD dwChannelGroup,
381 DWORD dwChannelMessage) PURE;
382
383 STDMETHOD(PackUnstructured) (THIS_ REFERENCE_TIME rt,
384 DWORD dwChannelGroup,
385 DWORD cb,
386 LPBYTE lpb) PURE;
387
388 STDMETHOD(ResetReadPtr) (THIS) PURE;
389 STDMETHOD(GetNextEvent) (THIS_ LPREFERENCE_TIME prt,
390 LPDWORD pdwChannelGroup,
391 LPDWORD pdwLength,
392 LPBYTE *ppData) PURE;
393
394 STDMETHOD(GetRawBufferPtr) (THIS_ LPBYTE *ppData) PURE;
395 STDMETHOD(GetStartTime) (THIS_ LPREFERENCE_TIME prt) PURE;
396 STDMETHOD(GetUsedBytes) (THIS_ LPDWORD pcb) PURE;
397 STDMETHOD(GetMaxBytes) (THIS_ LPDWORD pcb) PURE;
398 STDMETHOD(GetBufferFormat) (THIS_ LPGUID pGuidFormat) PURE;
399
400 STDMETHOD(SetStartTime) (THIS_ REFERENCE_TIME rt) PURE;
401 STDMETHOD(SetUsedBytes) (THIS_ DWORD cb) PURE;
402 };
403
404 typedef IDirectMusicBuffer IDirectMusicBuffer8;
405 typedef IDirectMusicBuffer8 *LPDIRECTMUSICBUFFER8;
406
407 #undef INTERFACE
408 #define INTERFACE IDirectMusicInstrument
409 DECLARE_INTERFACE_(IDirectMusicInstrument, IUnknown)
410 {
411 /* IUnknown */
412 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
413 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
414 STDMETHOD_(ULONG,Release) (THIS) PURE;
415
416 /* IDirectMusicInstrument */
417 STDMETHOD(GetPatch) (THIS_ DWORD* pdwPatch) PURE;
418 STDMETHOD(SetPatch) (THIS_ DWORD dwPatch) PURE;
419 };
420
421 typedef IDirectMusicInstrument IDirectMusicInstrument8;
422 typedef IDirectMusicInstrument8 *LPDIRECTMUSICINSTRUMENT8;
423
424 #undef INTERFACE
425 #define INTERFACE IDirectMusicDownloadedInstrument
426 DECLARE_INTERFACE_(IDirectMusicDownloadedInstrument, IUnknown)
427 {
428 /* IUnknown */
429 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
430 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
431 STDMETHOD_(ULONG,Release) (THIS) PURE;
432
433 /* IDirectMusicDownloadedInstrument */
434 /* None at this time */
435 };
436
437 typedef IDirectMusicDownloadedInstrument IDirectMusicDownloadedInstrument8;
438 typedef IDirectMusicDownloadedInstrument8 *LPDIRECTMUSICDOWNLOADEDINSTRUMENT8;
439
440 #undef INTERFACE
441 #define INTERFACE IDirectMusicCollection
442 DECLARE_INTERFACE_(IDirectMusicCollection, IUnknown)
443 {
444 /* IUnknown */
445 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
446 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
447 STDMETHOD_(ULONG,Release) (THIS) PURE;
448
449 /* IDirectMusicCollection */
450 STDMETHOD(GetInstrument) (THIS_ DWORD dwPatch,
451 IDirectMusicInstrument** ppInstrument) PURE;
452 STDMETHOD(EnumInstrument) (THIS_ DWORD dwIndex,
453 DWORD* pdwPatch,
454 LPWSTR pwszName,
455 DWORD dwNameLen) PURE;
456 };
457
458 typedef IDirectMusicCollection IDirectMusicCollection8;
459 typedef IDirectMusicCollection8 *LPDIRECTMUSICCOLLECTION8;
460
461 #undef INTERFACE
462 #define INTERFACE IDirectMusicDownload
463 DECLARE_INTERFACE_(IDirectMusicDownload , IUnknown)
464 {
465 /* IUnknown */
466 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
467 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
468 STDMETHOD_(ULONG,Release) (THIS) PURE;
469
470 /* IDirectMusicDownload */
471 STDMETHOD(GetBuffer) (THIS_ void** ppvBuffer,
472 DWORD* pdwSize) PURE;
473 };
474
475 typedef IDirectMusicDownload IDirectMusicDownload8;
476 typedef IDirectMusicDownload8 *LPDIRECTMUSICDOWNLOAD8;
477
478 #undef INTERFACE
479 #define INTERFACE IDirectMusicPortDownload
480 DECLARE_INTERFACE_(IDirectMusicPortDownload, IUnknown)
481 {
482 /* IUnknown */
483 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
484 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
485 STDMETHOD_(ULONG,Release) (THIS) PURE;
486
487 /* IDirectMusicPortDownload */
488 STDMETHOD(GetBuffer) (THIS_ DWORD dwDLId,
489 IDirectMusicDownload** ppIDMDownload) PURE;
490 STDMETHOD(AllocateBuffer) (THIS_ DWORD dwSize,
491 IDirectMusicDownload** ppIDMDownload) PURE;
492 STDMETHOD(GetDLId) (THIS_ DWORD* pdwStartDLId,
493 DWORD dwCount) PURE;
494 STDMETHOD(GetAppend) (THIS_ DWORD* pdwAppend) PURE;
495 STDMETHOD(Download) (THIS_ IDirectMusicDownload* pIDMDownload) PURE;
496 STDMETHOD(Unload) (THIS_ IDirectMusicDownload* pIDMDownload) PURE;
497 };
498
499 typedef IDirectMusicPortDownload IDirectMusicPortDownload8;
500 typedef IDirectMusicPortDownload8 *LPDIRECTMUSICPORTDOWNLOAD8;
501
502 /* Standard values for voice priorities. Numerically higher priorities are higher in priority.
503 * These priorities are used to set the voice priority for all voices on a channel. They are
504 * used in the dwPriority parameter of IDirectMusicPort::GetPriority and returned in the
505 * lpwPriority parameter of pdwPriority.
506 *
507 * These priorities are shared with DirectSound.
508 */
509
510 #ifndef _DIRECTAUDIO_PRIORITIES_DEFINED_
511 #define _DIRECTAUDIO_PRIORITIES_DEFINED_
512
513 #define DAUD_CRITICAL_VOICE_PRIORITY (0xF0000000)
514 #define DAUD_HIGH_VOICE_PRIORITY (0xC0000000)
515 #define DAUD_STANDARD_VOICE_PRIORITY (0x80000000)
516 #define DAUD_LOW_VOICE_PRIORITY (0x40000000)
517 #define DAUD_PERSIST_VOICE_PRIORITY (0x10000000)
518
519 /* These are the default priorities assigned if not overridden. By default priorities are
520 * equal across channel groups (e.g. channel 5 on channel group 1 has the same priority as
521 * channel 5 on channel group 2).
522 *
523 * In accordance with DLS level 1, channel 10 has the highest priority, followed by 1 through 16
524 * except for 10.
525 */
526 #define DAUD_CHAN1_VOICE_PRIORITY_OFFSET (0x0000000E)
527 #define DAUD_CHAN2_VOICE_PRIORITY_OFFSET (0x0000000D)
528 #define DAUD_CHAN3_VOICE_PRIORITY_OFFSET (0x0000000C)
529 #define DAUD_CHAN4_VOICE_PRIORITY_OFFSET (0x0000000B)
530 #define DAUD_CHAN5_VOICE_PRIORITY_OFFSET (0x0000000A)
531 #define DAUD_CHAN6_VOICE_PRIORITY_OFFSET (0x00000009)
532 #define DAUD_CHAN7_VOICE_PRIORITY_OFFSET (0x00000008)
533 #define DAUD_CHAN8_VOICE_PRIORITY_OFFSET (0x00000007)
534 #define DAUD_CHAN9_VOICE_PRIORITY_OFFSET (0x00000006)
535 #define DAUD_CHAN10_VOICE_PRIORITY_OFFSET (0x0000000F)
536 #define DAUD_CHAN11_VOICE_PRIORITY_OFFSET (0x00000005)
537 #define DAUD_CHAN12_VOICE_PRIORITY_OFFSET (0x00000004)
538 #define DAUD_CHAN13_VOICE_PRIORITY_OFFSET (0x00000003)
539 #define DAUD_CHAN14_VOICE_PRIORITY_OFFSET (0x00000002)
540 #define DAUD_CHAN15_VOICE_PRIORITY_OFFSET (0x00000001)
541 #define DAUD_CHAN16_VOICE_PRIORITY_OFFSET (0x00000000)
542
543
544 #define DAUD_CHAN1_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN1_VOICE_PRIORITY_OFFSET)
545 #define DAUD_CHAN2_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN2_VOICE_PRIORITY_OFFSET)
546 #define DAUD_CHAN3_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN3_VOICE_PRIORITY_OFFSET)
547 #define DAUD_CHAN4_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN4_VOICE_PRIORITY_OFFSET)
548 #define DAUD_CHAN5_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN5_VOICE_PRIORITY_OFFSET)
549 #define DAUD_CHAN6_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN6_VOICE_PRIORITY_OFFSET)
550 #define DAUD_CHAN7_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN7_VOICE_PRIORITY_OFFSET)
551 #define DAUD_CHAN8_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN8_VOICE_PRIORITY_OFFSET)
552 #define DAUD_CHAN9_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN9_VOICE_PRIORITY_OFFSET)
553 #define DAUD_CHAN10_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN10_VOICE_PRIORITY_OFFSET)
554 #define DAUD_CHAN11_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN11_VOICE_PRIORITY_OFFSET)
555 #define DAUD_CHAN12_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN12_VOICE_PRIORITY_OFFSET)
556 #define DAUD_CHAN13_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN13_VOICE_PRIORITY_OFFSET)
557 #define DAUD_CHAN14_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN14_VOICE_PRIORITY_OFFSET)
558 #define DAUD_CHAN15_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN15_VOICE_PRIORITY_OFFSET)
559 #define DAUD_CHAN16_DEF_VOICE_PRIORITY (DAUD_STANDARD_VOICE_PRIORITY | DAUD_CHAN16_VOICE_PRIORITY_OFFSET)
560
561 #endif /* _DIRECTAUDIO_PRIORITIES_DEFINED_ */
562
563
564 #undef INTERFACE
565 #define INTERFACE IDirectMusicPort
566 DECLARE_INTERFACE_(IDirectMusicPort, IUnknown)
567 {
568 /* IUnknown */
569 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
570 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
571 STDMETHOD_(ULONG,Release) (THIS) PURE;
572
573 /* IDirectMusicPort */
574 /* */
575 STDMETHOD(PlayBuffer) (THIS_ LPDIRECTMUSICBUFFER pBuffer) PURE;
576 STDMETHOD(SetReadNotificationHandle) (THIS_ HANDLE hEvent) PURE;
577 STDMETHOD(Read) (THIS_ LPDIRECTMUSICBUFFER pBuffer) PURE;
578 STDMETHOD(DownloadInstrument) (THIS_ IDirectMusicInstrument *pInstrument,
579 IDirectMusicDownloadedInstrument **ppDownloadedInstrument,
580 DMUS_NOTERANGE *pNoteRanges,
581 DWORD dwNumNoteRanges) PURE;
582 STDMETHOD(UnloadInstrument) (THIS_ IDirectMusicDownloadedInstrument *pDownloadedInstrument) PURE;
583 STDMETHOD(GetLatencyClock) (THIS_ IReferenceClock **ppClock) PURE;
584 STDMETHOD(GetRunningStats) (THIS_ LPDMUS_SYNTHSTATS pStats) PURE;
585 STDMETHOD(Compact) (THIS) PURE;
586 STDMETHOD(GetCaps) (THIS_ LPDMUS_PORTCAPS pPortCaps) PURE;
587 STDMETHOD(DeviceIoControl) (THIS_ DWORD dwIoControlCode,
588 LPVOID lpInBuffer,
589 DWORD nInBufferSize,
590 LPVOID lpOutBuffer,
591 DWORD nOutBufferSize,
592 LPDWORD lpBytesReturned,
593 LPOVERLAPPED lpOverlapped) PURE;
594 STDMETHOD(SetNumChannelGroups) (THIS_ DWORD dwChannelGroups) PURE;
595 STDMETHOD(GetNumChannelGroups) (THIS_ LPDWORD pdwChannelGroups) PURE;
596 STDMETHOD(Activate) (THIS_ BOOL fActive) PURE;
597 STDMETHOD(SetChannelPriority) (THIS_ DWORD dwChannelGroup, DWORD dwChannel, DWORD dwPriority) PURE;
598 STDMETHOD(GetChannelPriority) (THIS_ DWORD dwChannelGroup, DWORD dwChannel, LPDWORD pdwPriority) PURE;
599 STDMETHOD(SetDirectSound) (THIS_ LPDIRECTSOUND pDirectSound, LPDIRECTSOUNDBUFFER pDirectSoundBuffer) PURE;
600 STDMETHOD(GetFormat) (THIS_ LPWAVEFORMATEX pWaveFormatEx, LPDWORD pdwWaveFormatExSize, LPDWORD pdwBufferSize) PURE;
601 };
602
603 typedef IDirectMusicPort IDirectMusicPort8;
604 typedef IDirectMusicPort8 *LPDIRECTMUSICPORT8;
605
606 #undef INTERFACE
607 #define INTERFACE IDirectMusicThru
608 DECLARE_INTERFACE_(IDirectMusicThru, IUnknown)
609 {
610 /* IUnknown */
611 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
612 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
613 STDMETHOD_(ULONG,Release) (THIS) PURE;
614
615 /* IDirectMusicThru
616 */
617 STDMETHOD(ThruChannel) (THIS_ DWORD dwSourceChannelGroup,
618 DWORD dwSourceChannel,
619 DWORD dwDestinationChannelGroup,
620 DWORD dwDestinationChannel,
621 LPDIRECTMUSICPORT pDestinationPort) PURE;
622 };
623
624 typedef IDirectMusicThru IDirectMusicThru8;
625 typedef IDirectMusicThru8 *LPDIRECTMUSICTHRU8;
626
627 #ifndef __IReferenceClock_INTERFACE_DEFINED__
628 #define __IReferenceClock_INTERFACE_DEFINED__
629
630 DEFINE_GUID(IID_IReferenceClock,0x56a86897,0x0ad4,0x11ce,0xb0,0x3a,0x00,0x20,0xaf,0x0b,0xa7,0x70);
631
632 #undef INTERFACE
633 #define INTERFACE IReferenceClock
634 DECLARE_INTERFACE_(IReferenceClock, IUnknown)
635 {
636 /* IUnknown */
637 STDMETHOD(QueryInterface) (THIS_ REFIID, LPVOID FAR *) PURE;
638 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
639 STDMETHOD_(ULONG,Release) (THIS) PURE;
640
641 /* IReferenceClock */
642 /* */
643
644 /* get the time now */
645 STDMETHOD(GetTime) (THIS_ REFERENCE_TIME *pTime) PURE;
646
647 /* ask for an async notification that a time has elapsed */
648 STDMETHOD(AdviseTime) (THIS_ REFERENCE_TIME baseTime, /* base time */
649 REFERENCE_TIME streamTime, /* stream offset time */
650 HANDLE hEvent, /* advise via this event */
651 DWORD * pdwAdviseCookie) PURE; /* where your cookie goes */
652
653 /* ask for an async periodic notification that a time has elapsed */
654 STDMETHOD(AdvisePeriodic) (THIS_ REFERENCE_TIME startTime, /* starting at this time */
655 REFERENCE_TIME periodTime, /* time between notifications */
656 HANDLE hSemaphore, /* advise via a semaphore */
657 DWORD * pdwAdviseCookie) PURE; /* where your cookie goes */
658
659 /* cancel a request for notification */
660 STDMETHOD(Unadvise) (THIS_ DWORD dwAdviseCookie) PURE;
661 };
662
663 #endif /* __IReferenceClock_INTERFACE_DEFINED__ */
664
665 DEFINE_GUID(CLSID_DirectMusic,0x636b9f10,0x0c7d,0x11d1,0x95,0xb2,0x00,0x20,0xaf,0xdc,0x74,0x21);
666 DEFINE_GUID(CLSID_DirectMusicCollection,0x480ff4b0, 0x28b2, 0x11d1, 0xbe, 0xf7, 0x0, 0xc0, 0x4f, 0xbf, 0x8f, 0xef);
667 DEFINE_GUID(CLSID_DirectMusicSynth,0x58C2B4D0,0x46E7,0x11D1,0x89,0xAC,0x00,0xA0,0xC9,0x05,0x41,0x29);
668
669 DEFINE_GUID(IID_IDirectMusic,0x6536115a,0x7b2d,0x11d2,0xba,0x18,0x00,0x00,0xf8,0x75,0xac,0x12);
670 DEFINE_GUID(IID_IDirectMusicBuffer,0xd2ac2878, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
671 DEFINE_GUID(IID_IDirectMusicPort, 0x08f2d8c9,0x37c2,0x11d2,0xb9,0xf9,0x00,0x00,0xf8,0x75,0xac,0x12);
672 DEFINE_GUID(IID_IDirectMusicThru, 0xced153e7, 0x3606, 0x11d2, 0xb9, 0xf9, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
673 DEFINE_GUID(IID_IDirectMusicPortDownload,0xd2ac287a, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
674 DEFINE_GUID(IID_IDirectMusicDownload,0xd2ac287b, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
675 DEFINE_GUID(IID_IDirectMusicCollection,0xd2ac287c, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
676 DEFINE_GUID(IID_IDirectMusicInstrument,0xd2ac287d, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
677 DEFINE_GUID(IID_IDirectMusicDownloadedInstrument,0xd2ac287e, 0xb39b, 0x11d1, 0x87, 0x4, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
678
679
680 /* Alternate interface ID for IID_IDirectMusic, available in DX7 release and after. */
681 DEFINE_GUID(IID_IDirectMusic2,0x6fc2cae1, 0xbc78, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
682
683 DEFINE_GUID(IID_IDirectMusic8,0x2d3629f7,0x813d,0x4939,0x85,0x08,0xf0,0x5c,0x6b,0x75,0xfd,0x97);
684
685 #define IID_IDirectMusicThru8 IID_IDirectMusicThru
686 #define IID_IDirectMusicPortDownload8 IID_IDirectMusicPortDownload
687 #define IID_IDirectMusicDownload8 IID_IDirectMusicDownload
688 #define IID_IDirectMusicCollection8 IID_IDirectMusicCollection
689 #define IID_IDirectMusicInstrument8 IID_IDirectMusicInstrument
690 #define IID_IDirectMusicDownloadedInstrument8 IID_IDirectMusicDownloadedInstrument
691 #define IID_IDirectMusicPort8 IID_IDirectMusicPort
692
693
694 /* Property Query GUID_DMUS_PROP_GM_Hardware - Local GM set, no need to download
695 * Property Query GUID_DMUS_PROP_GS_Hardware - Local GS set, no need to download
696 * Property Query GUID_DMUS_PROP_XG_Hardware - Local XG set, no need to download
697 * Property Query GUID_DMUS_PROP_DLS1 - Support DLS level 1
698 * Property Query GUID_DMUS_PROP_INSTRUMENT2 - Support new INSTRUMENT2 download format
699 * Property Query GUID_DMUS_PROP_XG_Capable - Support minimum requirements of XG
700 * Property Query GUID_DMUS_PROP_GS_Capable - Support minimum requirements of GS
701 * Property Query GUID_DMUS_PROP_SynthSink_DSOUND - Synthsink talks to DirectSound
702 * Property Query GUID_DMUS_PROP_SynthSink_WAVE - Synthsink talks to Wave device
703 *
704 * Item 0: Supported
705 * Returns a DWORD which is non-zero if the feature is supported
706 */
707 DEFINE_GUID(GUID_DMUS_PROP_GM_Hardware, 0x178f2f24, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
708 DEFINE_GUID(GUID_DMUS_PROP_GS_Hardware, 0x178f2f25, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
709 DEFINE_GUID(GUID_DMUS_PROP_XG_Hardware, 0x178f2f26, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
710 DEFINE_GUID(GUID_DMUS_PROP_XG_Capable, 0x6496aba1, 0x61b0, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
711 DEFINE_GUID(GUID_DMUS_PROP_GS_Capable, 0x6496aba2, 0x61b0, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
712 DEFINE_GUID(GUID_DMUS_PROP_DLS1, 0x178f2f27, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
713 DEFINE_GUID(GUID_DMUS_PROP_DLS2, 0xf14599e5, 0x4689, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
714 DEFINE_GUID(GUID_DMUS_PROP_INSTRUMENT2, 0x865fd372, 0x9f67, 0x11d2, 0x87, 0x2a, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
715 DEFINE_GUID(GUID_DMUS_PROP_SynthSink_DSOUND,0xaa97844, 0xc877, 0x11d1, 0x87, 0xc, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
716 DEFINE_GUID(GUID_DMUS_PROP_SynthSink_WAVE,0xaa97845, 0xc877, 0x11d1, 0x87, 0xc, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
717 DEFINE_GUID(GUID_DMUS_PROP_SampleMemorySize, 0x178f2f28, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
718 DEFINE_GUID(GUID_DMUS_PROP_SamplePlaybackRate, 0x2a91f713, 0xa4bf, 0x11d2, 0xbb, 0xdf, 0x0, 0x60, 0x8, 0x33, 0xdb, 0xd8);
719
720 /* Property Get/Set GUID_DMUS_PROP_WriteLatency
721 *
722 * Item 0: Synth buffer write latency, in milliseconds
723 * Get/Set SynthSink latency, the average time after the play head that the next buffer gets written.
724 */
725 DEFINE_GUID(GUID_DMUS_PROP_WriteLatency,0x268a0fa0, 0x60f2, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
726
727 /* Property Get/Set GUID_DMUS_PROP_WritePeriod
728 *
729 * Item 0: Synth buffer write period, in milliseconds
730 * Get/Set SynthSink buffer write period, time span between successive writes.
731 */
732 DEFINE_GUID(GUID_DMUS_PROP_WritePeriod,0x268a0fa1, 0x60f2, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
733
734 /* Property Get GUID_DMUS_PROP_MemorySize
735 *
736 * Item 0: Memory size
737 * Returns a DWORD containing the total number of bytes of sample RAM
738 */
739 DEFINE_GUID(GUID_DMUS_PROP_MemorySize, 0x178f2f28, 0xc364, 0x11d1, 0xa7, 0x60, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
740
741 /* Property Set GUID_DMUS_PROP_WavesReverb
742 *
743 * Item 0: DMUS_WAVES_REVERB structure
744 * Sets reverb parameters
745 */
746 DEFINE_GUID(GUID_DMUS_PROP_WavesReverb,0x4cb5622, 0x32e5, 0x11d2, 0xaf, 0xa6, 0x0, 0xaa, 0x0, 0x24, 0xd8, 0xb6);
747
748 /* Property Set GUID_DMUS_PROP_Effects
749 *
750 * Item 0: DWORD with effects flags.
751 * Get/Set effects bits, same as dwEffectFlags in DMUS_PORTPARAMS and DMUS_PORTCAPS:
752 * DMUS_EFFECT_NONE
753 * DMUS_EFFECT_REVERB
754 * DMUS_EFFECT_CHORUS
755 */
756 DEFINE_GUID(GUID_DMUS_PROP_Effects, 0xcda8d611, 0x684a, 0x11d2, 0x87, 0x1e, 0x0, 0x60, 0x8, 0x93, 0xb1, 0xbd);
757
758 /* Property Set GUID_DMUS_PROP_LegacyCaps
759 *
760 * Item 0: The MIDINCAPS or MIDIOUTCAPS which describes the port's underlying WinMM device. This property is only supported
761 * by ports which wrap WinMM devices.
762 */
763
764 DEFINE_GUID(GUID_DMUS_PROP_LegacyCaps,0xcfa7cdc2, 0x00a1, 0x11d2, 0xaa, 0xd5, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
765
766 /* Property Set GUID_DMUS_PROP_Volume
767 *
768 * Item 0: A long which contains an offset, in 1/100 dB, to be added to the final volume
769 *
770 */
771 DEFINE_GUID(GUID_DMUS_PROP_Volume, 0xfedfae25L, 0xe46e, 0x11d1, 0xaa, 0xce, 0x00, 0x00, 0xf8, 0x75, 0xac, 0x12);
772
773 /* Min and Max values for setting volume with GUID_DMUS_PROP_Volume */
774
775 #define DMUS_VOLUME_MAX 2000 /* +20 dB */
776 #define DMUS_VOLUME_MIN -20000 /* -200 dB */
777
778 #ifdef __cplusplus
779 }; /* extern "C" */
780 #endif
781
782 #include <poppack.h>
783
784 #endif /* #ifndef _DMUSICC_ */