xref: /reactos/dll/directx/wine/dmusic/dmusic_main.c (revision c1cf2ac3)
1 /* DirectMusic Main
2  *
3  * Copyright (C) 2003-2004 Rok Mandeljc
4  *
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this program; if not, write to the Free Software
17  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
18  */
19 
20 
21 #include <stdio.h>
22 #include <stdarg.h>
23 
24 #define COBJMACROS
25 
26 #include "windef.h"
27 #include "winbase.h"
28 #include "winnt.h"
29 #include "wingdi.h"
30 #include "winuser.h"
31 #include "winreg.h"
32 #include "objbase.h"
33 #include "rpcproxy.h"
34 #include "initguid.h"
35 #include "dmusici.h"
36 
37 #include "dmusic_private.h"
38 
39 WINE_DEFAULT_DEBUG_CHANNEL(dmusic);
40 
41 static HINSTANCE instance;
42 LONG DMUSIC_refCount = 0;
43 
44 typedef struct {
45         IClassFactory IClassFactory_iface;
46         HRESULT (WINAPI *fnCreateInstance)(REFIID riid, void **ppv, IUnknown *pUnkOuter);
47 } IClassFactoryImpl;
48 
49 /******************************************************************
50  *      IClassFactory implementation
51  */
impl_from_IClassFactory(IClassFactory * iface)52 static inline IClassFactoryImpl *impl_from_IClassFactory(IClassFactory *iface)
53 {
54         return CONTAINING_RECORD(iface, IClassFactoryImpl, IClassFactory_iface);
55 }
56 
ClassFactory_QueryInterface(IClassFactory * iface,REFIID riid,void ** ppv)57 static HRESULT WINAPI ClassFactory_QueryInterface(IClassFactory *iface, REFIID riid, void **ppv)
58 {
59         if (ppv == NULL)
60                 return E_POINTER;
61 
62         if (IsEqualGUID(&IID_IUnknown, riid))
63                 TRACE("(%p)->(IID_IUnknown %p)\n", iface, ppv);
64         else if (IsEqualGUID(&IID_IClassFactory, riid))
65                 TRACE("(%p)->(IID_IClassFactory %p)\n", iface, ppv);
66         else {
67                 FIXME("(%p)->(%s %p)\n", iface, debugstr_guid(riid), ppv);
68                 *ppv = NULL;
69                 return E_NOINTERFACE;
70         }
71 
72         *ppv = iface;
73         IUnknown_AddRef((IUnknown*)*ppv);
74         return S_OK;
75 }
76 
ClassFactory_AddRef(IClassFactory * iface)77 static ULONG WINAPI ClassFactory_AddRef(IClassFactory *iface)
78 {
79         DMUSIC_LockModule();
80 
81         return 2; /* non-heap based object */
82 }
83 
ClassFactory_Release(IClassFactory * iface)84 static ULONG WINAPI ClassFactory_Release(IClassFactory *iface)
85 {
86         DMUSIC_UnlockModule();
87 
88         return 1; /* non-heap based object */
89 }
90 
ClassFactory_CreateInstance(IClassFactory * iface,IUnknown * pUnkOuter,REFIID riid,void ** ppv)91 static HRESULT WINAPI ClassFactory_CreateInstance(IClassFactory *iface, IUnknown *pUnkOuter,
92         REFIID riid, void **ppv)
93 {
94         IClassFactoryImpl *This = impl_from_IClassFactory(iface);
95 
96         TRACE ("(%p, %s, %p)\n", pUnkOuter, debugstr_dmguid(riid), ppv);
97 
98         return This->fnCreateInstance(riid, ppv, pUnkOuter);
99 }
100 
ClassFactory_LockServer(IClassFactory * iface,BOOL dolock)101 static HRESULT WINAPI ClassFactory_LockServer(IClassFactory *iface, BOOL dolock)
102 {
103         TRACE("(%d)\n", dolock);
104 
105         if (dolock)
106                 DMUSIC_LockModule();
107         else
108                 DMUSIC_UnlockModule();
109 
110         return S_OK;
111 }
112 
113 static const IClassFactoryVtbl classfactory_vtbl = {
114         ClassFactory_QueryInterface,
115         ClassFactory_AddRef,
116         ClassFactory_Release,
117         ClassFactory_CreateInstance,
118         ClassFactory_LockServer
119 };
120 
121 static IClassFactoryImpl DirectMusic_CF = {{&classfactory_vtbl}, DMUSIC_CreateDirectMusicImpl};
122 static IClassFactoryImpl Collection_CF = {{&classfactory_vtbl},
123                                           DMUSIC_CreateDirectMusicCollectionImpl};
124 
125 /******************************************************************
126  *		DllMain
127  *
128  *
129  */
DllMain(HINSTANCE hinstDLL,DWORD fdwReason,LPVOID lpvReserved)130 BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) {
131 	if (fdwReason == DLL_PROCESS_ATTACH) {
132             instance = hinstDLL;
133             DisableThreadLibraryCalls(hinstDLL);
134 	}
135 
136 	return TRUE;
137 }
138 
139 
140 /******************************************************************
141  *		DllCanUnloadNow (DMUSIC.@)
142  *
143  *
144  */
DllCanUnloadNow(void)145 HRESULT WINAPI DllCanUnloadNow(void)
146 {
147 	return DMUSIC_refCount != 0 ? S_FALSE : S_OK;
148 }
149 
150 
151 /******************************************************************
152  *		DllGetClassObject (DMUSIC.@)
153  *
154  *
155  */
DllGetClassObject(REFCLSID rclsid,REFIID riid,LPVOID * ppv)156 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
157 {
158 	TRACE("(%s, %s, %p)\n", debugstr_dmguid(rclsid), debugstr_dmguid(riid), ppv);
159 	if (IsEqualCLSID (rclsid, &CLSID_DirectMusic) && IsEqualIID (riid, &IID_IClassFactory)) {
160 		*ppv = &DirectMusic_CF;
161 		IClassFactory_AddRef((IClassFactory*)*ppv);
162 		return S_OK;
163 	} else if (IsEqualCLSID (rclsid, &CLSID_DirectMusicCollection) && IsEqualIID (riid, &IID_IClassFactory)) {
164 		*ppv = &Collection_CF;
165 		IClassFactory_AddRef((IClassFactory*)*ppv);
166 		return S_OK;
167 	}
168 
169     WARN("(%s, %s, %p): no interface found.\n", debugstr_dmguid(rclsid), debugstr_dmguid(riid), ppv);
170     return CLASS_E_CLASSNOTAVAILABLE;
171 }
172 
173 /***********************************************************************
174  *		DllRegisterServer (DMUSIC.@)
175  */
DllRegisterServer(void)176 HRESULT WINAPI DllRegisterServer(void)
177 {
178     return __wine_register_resources( instance );
179 }
180 
181 /***********************************************************************
182  *		DllUnregisterServer (DMUSIC.@)
183  */
DllUnregisterServer(void)184 HRESULT WINAPI DllUnregisterServer(void)
185 {
186     return __wine_unregister_resources( instance );
187 }
188 
189 /******************************************************************
190  *		Helper functions
191  *
192  *
193  */
194 /* dwPatch from MIDILOCALE */
MIDILOCALE2Patch(const MIDILOCALE * pLocale)195 DWORD MIDILOCALE2Patch (const MIDILOCALE *pLocale) {
196 	DWORD dwPatch = 0;
197 	if (!pLocale) return 0;
198 	dwPatch |= (pLocale->ulBank & F_INSTRUMENT_DRUMS); /* set drum bit */
199 	dwPatch |= ((pLocale->ulBank & 0x00007F7F) << 8); /* set MIDI bank location */
200 	dwPatch |= (pLocale->ulInstrument & 0x0000007F); /* set PC value */
201 	return dwPatch;
202 }
203 
204 /* MIDILOCALE from dwPatch */
Patch2MIDILOCALE(DWORD dwPatch,LPMIDILOCALE pLocale)205 void Patch2MIDILOCALE (DWORD dwPatch, LPMIDILOCALE pLocale) {
206 	memset (pLocale, 0, sizeof(MIDILOCALE));
207 
208 	pLocale->ulInstrument = (dwPatch & 0x7F); /* get PC value */
209 	pLocale->ulBank = ((dwPatch & 0x007F7F00) >> 8); /* get MIDI bank location */
210 	pLocale->ulBank |= (dwPatch & F_INSTRUMENT_DRUMS); /* get drum bit */
211 }
212 
213 /* check whether the given DWORD is even (return 0) or odd (return 1) */
even_or_odd(DWORD number)214 int even_or_odd (DWORD number) {
215 	return (number & 0x1); /* basically, check if bit 0 is set ;) */
216 }
217 
218 /* FOURCC to string conversion for debug messages */
debugstr_fourcc(DWORD fourcc)219 const char *debugstr_fourcc (DWORD fourcc) {
220     if (!fourcc) return "'null'";
221     return wine_dbg_sprintf ("\'%c%c%c%c\'",
222 		(char)(fourcc), (char)(fourcc >> 8),
223         (char)(fourcc >> 16), (char)(fourcc >> 24));
224 }
225 
226 /* DMUS_VERSION struct to string conversion for debug messages */
debugstr_dmversion(const DMUS_VERSION * version)227 static const char *debugstr_dmversion(const DMUS_VERSION *version)
228 {
229     if (!version)
230         return "'null'";
231     return wine_dbg_sprintf("'%hu,%hu,%hu,%hu'",
232             HIWORD(version->dwVersionMS), LOWORD(version->dwVersionMS),
233             HIWORD(version->dwVersionLS), LOWORD(version->dwVersionLS));
234 }
235 
236 /* returns name of given GUID */
debugstr_dmguid(const GUID * id)237 const char *debugstr_dmguid (const GUID *id) {
238 	static const guid_info guids[] = {
239 		/* CLSIDs */
240 		GE(CLSID_AudioVBScript),
241 		GE(CLSID_DirectMusic),
242 		GE(CLSID_DirectMusicAudioPathConfig),
243 		GE(CLSID_DirectMusicAuditionTrack),
244 		GE(CLSID_DirectMusicBand),
245 		GE(CLSID_DirectMusicBandTrack),
246 		GE(CLSID_DirectMusicChordMapTrack),
247 		GE(CLSID_DirectMusicChordMap),
248 		GE(CLSID_DirectMusicChordTrack),
249 		GE(CLSID_DirectMusicCollection),
250 		GE(CLSID_DirectMusicCommandTrack),
251 		GE(CLSID_DirectMusicComposer),
252 		GE(CLSID_DirectMusicContainer),
253 		GE(CLSID_DirectMusicGraph),
254 		GE(CLSID_DirectMusicLoader),
255 		GE(CLSID_DirectMusicLyricsTrack),
256 		GE(CLSID_DirectMusicMarkerTrack),
257 		GE(CLSID_DirectMusicMelodyFormulationTrack),
258 		GE(CLSID_DirectMusicMotifTrack),
259 		GE(CLSID_DirectMusicMuteTrack),
260 		GE(CLSID_DirectMusicParamControlTrack),
261 		GE(CLSID_DirectMusicPatternTrack),
262 		GE(CLSID_DirectMusicPerformance),
263 		GE(CLSID_DirectMusicScript),
264 		GE(CLSID_DirectMusicScriptAutoImpSegment),
265 		GE(CLSID_DirectMusicScriptAutoImpPerformance),
266 		GE(CLSID_DirectMusicScriptAutoImpSegmentState),
267 		GE(CLSID_DirectMusicScriptAutoImpAudioPathConfig),
268 		GE(CLSID_DirectMusicScriptAutoImpAudioPath),
269 		GE(CLSID_DirectMusicScriptAutoImpSong),
270 		GE(CLSID_DirectMusicScriptSourceCodeLoader),
271 		GE(CLSID_DirectMusicScriptTrack),
272 		GE(CLSID_DirectMusicSection),
273 		GE(CLSID_DirectMusicSegment),
274 		GE(CLSID_DirectMusicSegmentState),
275 		GE(CLSID_DirectMusicSegmentTriggerTrack),
276 		GE(CLSID_DirectMusicSegTriggerTrack),
277 		GE(CLSID_DirectMusicSeqTrack),
278 		GE(CLSID_DirectMusicSignPostTrack),
279 		GE(CLSID_DirectMusicSong),
280 		GE(CLSID_DirectMusicStyle),
281 		GE(CLSID_DirectMusicStyleTrack),
282 		GE(CLSID_DirectMusicSynth),
283 		GE(CLSID_DirectMusicSynthSink),
284 		GE(CLSID_DirectMusicSysExTrack),
285 		GE(CLSID_DirectMusicTemplate),
286 		GE(CLSID_DirectMusicTempoTrack),
287 		GE(CLSID_DirectMusicTimeSigTrack),
288 		GE(CLSID_DirectMusicWaveTrack),
289 		GE(CLSID_DirectSoundWave),
290 		/* IIDs */
291 		GE(IID_IDirectMusic),
292 		GE(IID_IDirectMusic2),
293 		GE(IID_IDirectMusic8),
294 		GE(IID_IDirectMusicAudioPath),
295 		GE(IID_IDirectMusicBand),
296 		GE(IID_IDirectMusicBuffer),
297 		GE(IID_IDirectMusicChordMap),
298 		GE(IID_IDirectMusicCollection),
299 		GE(IID_IDirectMusicComposer),
300 		GE(IID_IDirectMusicContainer),
301 		GE(IID_IDirectMusicDownload),
302 		GE(IID_IDirectMusicDownloadedInstrument),
303 		GE(IID_IDirectMusicGetLoader),
304 		GE(IID_IDirectMusicGraph),
305 		GE(IID_IDirectMusicInstrument),
306 		GE(IID_IDirectMusicLoader),
307 		GE(IID_IDirectMusicLoader8),
308 		GE(IID_IDirectMusicObject),
309 		GE(IID_IDirectMusicPatternTrack),
310 		GE(IID_IDirectMusicPerformance),
311 		GE(IID_IDirectMusicPerformance2),
312 		GE(IID_IDirectMusicPerformance8),
313 		GE(IID_IDirectMusicPort),
314 		GE(IID_IDirectMusicPortDownload),
315 		GE(IID_IDirectMusicScript),
316 		GE(IID_IDirectMusicSegment),
317 		GE(IID_IDirectMusicSegment2),
318 		GE(IID_IDirectMusicSegment8),
319 		GE(IID_IDirectMusicSegmentState),
320 		GE(IID_IDirectMusicSegmentState8),
321 		GE(IID_IDirectMusicStyle),
322 		GE(IID_IDirectMusicStyle8),
323 		GE(IID_IDirectMusicSynth),
324 		GE(IID_IDirectMusicSynth8),
325 		GE(IID_IDirectMusicSynthSink),
326 		GE(IID_IDirectMusicThru),
327 		GE(IID_IDirectMusicTool),
328 		GE(IID_IDirectMusicTool8),
329 		GE(IID_IDirectMusicTrack),
330 		GE(IID_IDirectMusicTrack8),
331 		GE(IID_IUnknown),
332 		GE(IID_IPersistStream),
333 		GE(IID_IStream),
334 		GE(IID_IClassFactory),
335 		/* GUIDs */
336 		GE(GUID_DirectMusicAllTypes),
337 		GE(GUID_NOTIFICATION_CHORD),
338 		GE(GUID_NOTIFICATION_COMMAND),
339 		GE(GUID_NOTIFICATION_MEASUREANDBEAT),
340 		GE(GUID_NOTIFICATION_PERFORMANCE),
341 		GE(GUID_NOTIFICATION_RECOMPOSE),
342 		GE(GUID_NOTIFICATION_SEGMENT),
343 		GE(GUID_BandParam),
344 		GE(GUID_ChordParam),
345 		GE(GUID_CommandParam),
346 		GE(GUID_CommandParam2),
347 		GE(GUID_CommandParamNext),
348 		GE(GUID_IDirectMusicBand),
349 		GE(GUID_IDirectMusicChordMap),
350 		GE(GUID_IDirectMusicStyle),
351 		GE(GUID_MuteParam),
352 		GE(GUID_Play_Marker),
353 		GE(GUID_RhythmParam),
354 		GE(GUID_TempoParam),
355 		GE(GUID_TimeSignature),
356 		GE(GUID_Valid_Start_Time),
357 		GE(GUID_Clear_All_Bands),
358 		GE(GUID_ConnectToDLSCollection),
359 		GE(GUID_Disable_Auto_Download),
360 		GE(GUID_DisableTempo),
361 		GE(GUID_DisableTimeSig),
362 		GE(GUID_Download),
363 		GE(GUID_DownloadToAudioPath),
364 		GE(GUID_Enable_Auto_Download),
365 		GE(GUID_EnableTempo),
366 		GE(GUID_EnableTimeSig),
367 		GE(GUID_IgnoreBankSelectForGM),
368 		GE(GUID_SeedVariations),
369 		GE(GUID_StandardMIDIFile),
370 		GE(GUID_Unload),
371 		GE(GUID_UnloadFromAudioPath),
372 		GE(GUID_Variations),
373 		GE(GUID_PerfMasterTempo),
374 		GE(GUID_PerfMasterVolume),
375 		GE(GUID_PerfMasterGrooveLevel),
376 		GE(GUID_PerfAutoDownload),
377 		GE(GUID_DefaultGMCollection),
378 		GE(GUID_Synth_Default),
379 		GE(GUID_Buffer_Reverb),
380 		GE(GUID_Buffer_EnvReverb),
381 		GE(GUID_Buffer_Stereo),
382 		GE(GUID_Buffer_3D_Dry),
383 		GE(GUID_Buffer_Mono),
384 		GE(GUID_DMUS_PROP_GM_Hardware),
385 		GE(GUID_DMUS_PROP_GS_Capable),
386 		GE(GUID_DMUS_PROP_GS_Hardware),
387 		GE(GUID_DMUS_PROP_DLS1),
388 		GE(GUID_DMUS_PROP_DLS2),
389 		GE(GUID_DMUS_PROP_Effects),
390 		GE(GUID_DMUS_PROP_INSTRUMENT2),
391 		GE(GUID_DMUS_PROP_LegacyCaps),
392 		GE(GUID_DMUS_PROP_MemorySize),
393 		GE(GUID_DMUS_PROP_SampleMemorySize),
394 		GE(GUID_DMUS_PROP_SamplePlaybackRate),
395 		GE(GUID_DMUS_PROP_SetSynthSink),
396 		GE(GUID_DMUS_PROP_SinkUsesDSound),
397 		GE(GUID_DMUS_PROP_SynthSink_DSOUND),
398 		GE(GUID_DMUS_PROP_SynthSink_WAVE),
399 		GE(GUID_DMUS_PROP_Volume),
400 		GE(GUID_DMUS_PROP_WavesReverb),
401 		GE(GUID_DMUS_PROP_WriteLatency),
402 		GE(GUID_DMUS_PROP_WritePeriod),
403 		GE(GUID_DMUS_PROP_XG_Capable),
404 		GE(GUID_DMUS_PROP_XG_Hardware)
405 	};
406 
407 	unsigned int i;
408 
409         if (!id) return "(null)";
410 
411 	for (i = 0; i < ARRAY_SIZE(guids); i++) {
412 		if (IsEqualGUID(id, guids[i].guid))
413 			return guids[i].name;
414 	}
415 	/* if we didn't find it, act like standard debugstr_guid */
416 	return debugstr_guid(id);
417 }
418 
419 /* generic flag-dumping function */
debugstr_flags(DWORD flags,const flag_info * names,size_t num_names)420 static const char* debugstr_flags (DWORD flags, const flag_info* names, size_t num_names){
421 	char buffer[128] = "", *ptr = &buffer[0];
422 	unsigned int i;
423 	int size = sizeof(buffer);
424 
425 	for (i=0; i < num_names; i++)
426 	{
427 		if ((flags & names[i].val) ||	/* standard flag*/
428 			((!flags) && (!names[i].val))) { /* zero value only */
429 				int cnt = snprintf(ptr, size, "%s ", names[i].name);
430 				if (cnt < 0 || cnt >= size) break;
431 				size -= cnt;
432 				ptr += cnt;
433 		}
434 	}
435 
436 	return wine_dbg_sprintf("%s", buffer);
437 }
438 
439 /* dump DMUS_OBJ flags */
debugstr_DMUS_OBJ_FLAGS(DWORD flagmask)440 static const char *debugstr_DMUS_OBJ_FLAGS (DWORD flagmask) {
441     static const flag_info flags[] = {
442 	    FE(DMUS_OBJ_OBJECT),
443 	    FE(DMUS_OBJ_CLASS),
444 	    FE(DMUS_OBJ_NAME),
445 	    FE(DMUS_OBJ_CATEGORY),
446 	    FE(DMUS_OBJ_FILENAME),
447 	    FE(DMUS_OBJ_FULLPATH),
448 	    FE(DMUS_OBJ_URL),
449 	    FE(DMUS_OBJ_VERSION),
450 	    FE(DMUS_OBJ_DATE),
451 	    FE(DMUS_OBJ_LOADED),
452 	    FE(DMUS_OBJ_MEMORY),
453 	    FE(DMUS_OBJ_STREAM)
454 	};
455     return debugstr_flags(flagmask, flags, ARRAY_SIZE(flags));
456 }
457 
458 /* Dump whole DMUS_OBJECTDESC struct */
dump_DMUS_OBJECTDESC(LPDMUS_OBJECTDESC desc)459 void dump_DMUS_OBJECTDESC(LPDMUS_OBJECTDESC desc)
460 {
461     TRACE("DMUS_OBJECTDESC (%p):\n", desc);
462     TRACE(" - dwSize = %d\n", desc->dwSize);
463     TRACE(" - dwValidData = %s\n", debugstr_DMUS_OBJ_FLAGS (desc->dwValidData));
464     if (desc->dwValidData & DMUS_OBJ_CLASS)    TRACE(" - guidClass = %s\n", debugstr_dmguid(&desc->guidClass));
465     if (desc->dwValidData & DMUS_OBJ_OBJECT)   TRACE(" - guidObject = %s\n", debugstr_guid(&desc->guidObject));
466     if (desc->dwValidData & DMUS_OBJ_DATE)     TRACE(" - ftDate = FIXME\n");
467     if (desc->dwValidData & DMUS_OBJ_VERSION)  TRACE(" - vVersion = %s\n", debugstr_dmversion(&desc->vVersion));
468     if (desc->dwValidData & DMUS_OBJ_NAME)     TRACE(" - wszName = %s\n", debugstr_w(desc->wszName));
469     if (desc->dwValidData & DMUS_OBJ_CATEGORY) TRACE(" - wszCategory = %s\n", debugstr_w(desc->wszCategory));
470     if (desc->dwValidData & DMUS_OBJ_FILENAME) TRACE(" - wszFileName = %s\n", debugstr_w(desc->wszFileName));
471     if (desc->dwValidData & DMUS_OBJ_MEMORY)   TRACE(" - llMemLength = 0x%s\n  - pbMemData = %p\n",
472                                                      wine_dbgstr_longlong(desc->llMemLength), desc->pbMemData);
473     if (desc->dwValidData & DMUS_OBJ_STREAM)   TRACE(" - pStream = %p\n", desc->pStream);
474 }
475 
476 /* Dump DMUS_PORTPARAMS flags */
debugstr_DMUS_PORTPARAMS_FLAGS(DWORD flagmask)477 static const char* debugstr_DMUS_PORTPARAMS_FLAGS(DWORD flagmask)
478 {
479     static const flag_info flags[] = {
480         FE(DMUS_PORTPARAMS_VOICES),
481         FE(DMUS_PORTPARAMS_CHANNELGROUPS),
482         FE(DMUS_PORTPARAMS_AUDIOCHANNELS),
483         FE(DMUS_PORTPARAMS_SAMPLERATE),
484         FE(DMUS_PORTPARAMS_EFFECTS),
485         FE(DMUS_PORTPARAMS_SHARE)
486     };
487     return debugstr_flags(flagmask, flags, ARRAY_SIZE(flags));
488 }
489 
490 /* Dump whole DMUS_PORTPARAMS struct */
dump_DMUS_PORTPARAMS(LPDMUS_PORTPARAMS params)491 void dump_DMUS_PORTPARAMS(LPDMUS_PORTPARAMS params)
492 {
493     TRACE("DMUS_PORTPARAMS (%p):\n", params);
494     TRACE(" - dwSize = %d\n", params->dwSize);
495     TRACE(" - dwValidParams = %s\n", debugstr_DMUS_PORTPARAMS_FLAGS(params->dwValidParams));
496     if (params->dwValidParams & DMUS_PORTPARAMS_VOICES)        TRACE(" - dwVoices = %u\n", params->dwVoices);
497     if (params->dwValidParams & DMUS_PORTPARAMS_CHANNELGROUPS) TRACE(" - dwChannelGroup = %u\n", params->dwChannelGroups);
498     if (params->dwValidParams & DMUS_PORTPARAMS_AUDIOCHANNELS) TRACE(" - dwAudioChannels = %u\n", params->dwAudioChannels);
499     if (params->dwValidParams & DMUS_PORTPARAMS_SAMPLERATE)    TRACE(" - dwSampleRate = %u\n", params->dwSampleRate);
500     if (params->dwValidParams & DMUS_PORTPARAMS_EFFECTS)       TRACE(" - dwEffectFlags = %x\n", params->dwEffectFlags);
501     if (params->dwValidParams & DMUS_PORTPARAMS_SHARE)         TRACE(" - fShare = %u\n", params->fShare);
502 }
503