dmusic_main.c

Go to the documentation of this file.

/* DirectMusic Main
 *
 * Copyright (C) 2003-2004 Rok Mandeljc
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
 */


#include <stdio.h>
#include <stdarg.h>

#define COBJMACROS

#include "windef.h"
#include "winbase.h"
#include "winnt.h"
#include "wingdi.h"
#include "winuser.h"
#include "winreg.h"
#include "objbase.h"
#include "rpcproxy.h"
#include "initguid.h"
#include "dmusici.h"

#include "dmusic_private.h"

WINE_DEFAULT_DEBUG_CHANNEL(dmusic);

static HINSTANCE instance;
LONG DMUSIC_refCount = 0;

typedef struct {
        IClassFactory IClassFactory_iface;
        HRESULT (WINAPI *fnCreateInstance)(REFIID riid, void **ppv, IUnknown *pUnkOuter);
} IClassFactoryImpl;

/******************************************************************
 *      IClassFactory implementation
 */
static inline IClassFactoryImpl *impl_from_IClassFactory(IClassFactory *iface)
{
        return CONTAINING_RECORD(iface, IClassFactoryImpl, IClassFactory_iface);
}

static HRESULT WINAPI ClassFactory_QueryInterface(IClassFactory *iface, REFIID riid, void **ppv)
{
        if (ppv == NULL)
                return E_POINTER;

        if (IsEqualGUID(&IID_IUnknown, riid))
                TRACE("(%p)->(IID_IUnknown %p)\n", iface, ppv);
        else if (IsEqualGUID(&IID_IClassFactory, riid))
                TRACE("(%p)->(IID_IClassFactory %p)\n", iface, ppv);
        else {
                FIXME("(%p)->(%s %p)\n", iface, debugstr_guid(riid), ppv);
                *ppv = NULL;
                return E_NOINTERFACE;
        }

        *ppv = iface;
        IUnknown_AddRef((IUnknown*)*ppv);
        return S_OK;
}

static ULONG WINAPI ClassFactory_AddRef(IClassFactory *iface)
{
        DMUSIC_LockModule();

        return 2; /* non-heap based object */
}

static ULONG WINAPI ClassFactory_Release(IClassFactory *iface)
{
        DMUSIC_UnlockModule();

        return 1; /* non-heap based object */
}

static HRESULT WINAPI ClassFactory_CreateInstance(IClassFactory *iface, IUnknown *pUnkOuter,
        REFIID riid, void **ppv)
{
        IClassFactoryImpl *This = impl_from_IClassFactory(iface);

        TRACE ("(%p, %s, %p)\n", pUnkOuter, debugstr_dmguid(riid), ppv);

        return This->fnCreateInstance(riid, ppv, pUnkOuter);
}

static HRESULT WINAPI ClassFactory_LockServer(IClassFactory *iface, BOOL dolock)
{
        TRACE("(%d)\n", dolock);

        if (dolock)
                DMUSIC_LockModule();
        else
                DMUSIC_UnlockModule();

        return S_OK;
}

static const IClassFactoryVtbl classfactory_vtbl = {
        ClassFactory_QueryInterface,
        ClassFactory_AddRef,
        ClassFactory_Release,
        ClassFactory_CreateInstance,
        ClassFactory_LockServer
};

static IClassFactoryImpl DirectMusic_CF = {{&classfactory_vtbl}, DMUSIC_CreateDirectMusicImpl};
static IClassFactoryImpl Collection_CF = {{&classfactory_vtbl},
                                          DMUSIC_CreateDirectMusicCollectionImpl};

/******************************************************************
 *      DllMain
 *
 *
 */
BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) {
    if (fdwReason == DLL_PROCESS_ATTACH) {
            instance = hinstDLL;
            DisableThreadLibraryCalls(hinstDLL);
    }

    return TRUE;
}


/******************************************************************
 *      DllCanUnloadNow (DMUSIC.@)
 *
 *
 */
HRESULT WINAPI DllCanUnloadNow(void)
{
    return DMUSIC_refCount != 0 ? S_FALSE : S_OK;
}


/******************************************************************
 *      DllGetClassObject (DMUSIC.@)
 *
 *
 */
HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
{
    TRACE("(%s, %s, %p)\n", debugstr_dmguid(rclsid), debugstr_dmguid(riid), ppv);
    if (IsEqualCLSID (rclsid, &CLSID_DirectMusic) && IsEqualIID (riid, &IID_IClassFactory)) {
        *ppv = &DirectMusic_CF;
        IClassFactory_AddRef((IClassFactory*)*ppv);
        return S_OK;
    } else if (IsEqualCLSID (rclsid, &CLSID_DirectMusicCollection) && IsEqualIID (riid, &IID_IClassFactory)) {
        *ppv = &Collection_CF;
        IClassFactory_AddRef((IClassFactory*)*ppv);
        return S_OK;
    }
    
    WARN("(%s, %s, %p): no interface found.\n", debugstr_dmguid(rclsid), debugstr_dmguid(riid), ppv);
    return CLASS_E_CLASSNOTAVAILABLE;
}

/***********************************************************************
 *      DllRegisterServer (DMUSIC.@)
 */
HRESULT WINAPI DllRegisterServer(void)
{
    return __wine_register_resources( instance );
}

/***********************************************************************
 *      DllUnregisterServer (DMUSIC.@)
 */
HRESULT WINAPI DllUnregisterServer(void)
{
    return __wine_unregister_resources( instance );
}

/******************************************************************
 *      Helper functions
 *
 *
 */
/* dwPatch from MIDILOCALE */
DWORD MIDILOCALE2Patch (const MIDILOCALE *pLocale) {
    DWORD dwPatch = 0;
    if (!pLocale) return 0;
    dwPatch |= (pLocale->ulBank & F_INSTRUMENT_DRUMS); /* set drum bit */
    dwPatch |= ((pLocale->ulBank & 0x00007F7F) << 8); /* set MIDI bank location */
    dwPatch |= (pLocale->ulInstrument & 0x0000007F); /* set PC value */
    return dwPatch; 
}

/* MIDILOCALE from dwPatch */
void Patch2MIDILOCALE (DWORD dwPatch, LPMIDILOCALE pLocale) {
    memset (pLocale, 0, sizeof(MIDILOCALE));
    
    pLocale->ulInstrument = (dwPatch & 0x7F); /* get PC value */
    pLocale->ulBank = ((dwPatch & 0x007F7F00) >> 8); /* get MIDI bank location */
    pLocale->ulBank |= (dwPatch & F_INSTRUMENT_DRUMS); /* get drum bit */
}

/* check whether the given DWORD is even (return 0) or odd (return 1) */
int even_or_odd (DWORD number) {
    return (number & 0x1); /* basically, check if bit 0 is set ;) */
}

/* FOURCC to string conversion for debug messages */
const char *debugstr_fourcc (DWORD fourcc) {
    if (!fourcc) return "'null'";
    return wine_dbg_sprintf ("\'%c%c%c%c\'",
        (char)(fourcc), (char)(fourcc >> 8),
        (char)(fourcc >> 16), (char)(fourcc >> 24));
}

/* DMUS_VERSION struct to string conversion for debug messages */
static const char *debugstr_dmversion(const DMUS_VERSION *version)
{
    if (!version)
        return "'null'";
    return wine_dbg_sprintf("'%hu,%hu,%hu,%hu'",
            HIWORD(version->dwVersionMS), LOWORD(version->dwVersionMS),
            HIWORD(version->dwVersionLS), LOWORD(version->dwVersionLS));
}

/* returns name of given GUID */
const char *debugstr_dmguid (const GUID *id) {
    static const guid_info guids[] = {
        /* CLSIDs */
        GE(CLSID_AudioVBScript),
        GE(CLSID_DirectMusic),
        GE(CLSID_DirectMusicAudioPathConfig),
        GE(CLSID_DirectMusicAuditionTrack),
        GE(CLSID_DirectMusicBand),
        GE(CLSID_DirectMusicBandTrack),
        GE(CLSID_DirectMusicChordMapTrack),
        GE(CLSID_DirectMusicChordMap),
        GE(CLSID_DirectMusicChordTrack),
        GE(CLSID_DirectMusicCollection),
        GE(CLSID_DirectMusicCommandTrack),
        GE(CLSID_DirectMusicComposer),
        GE(CLSID_DirectMusicContainer),
        GE(CLSID_DirectMusicGraph),
        GE(CLSID_DirectMusicLoader),
        GE(CLSID_DirectMusicLyricsTrack),
        GE(CLSID_DirectMusicMarkerTrack),
        GE(CLSID_DirectMusicMelodyFormulationTrack),
        GE(CLSID_DirectMusicMotifTrack),
        GE(CLSID_DirectMusicMuteTrack),
        GE(CLSID_DirectMusicParamControlTrack),
        GE(CLSID_DirectMusicPatternTrack),
        GE(CLSID_DirectMusicPerformance),
        GE(CLSID_DirectMusicScript),
        GE(CLSID_DirectMusicScriptAutoImpSegment),
        GE(CLSID_DirectMusicScriptAutoImpPerformance),
        GE(CLSID_DirectMusicScriptAutoImpSegmentState),
        GE(CLSID_DirectMusicScriptAutoImpAudioPathConfig),
        GE(CLSID_DirectMusicScriptAutoImpAudioPath),
        GE(CLSID_DirectMusicScriptAutoImpSong),
        GE(CLSID_DirectMusicScriptSourceCodeLoader),
        GE(CLSID_DirectMusicScriptTrack),
        GE(CLSID_DirectMusicSection),
        GE(CLSID_DirectMusicSegment),
        GE(CLSID_DirectMusicSegmentState),
        GE(CLSID_DirectMusicSegmentTriggerTrack),
        GE(CLSID_DirectMusicSegTriggerTrack),
        GE(CLSID_DirectMusicSeqTrack),
        GE(CLSID_DirectMusicSignPostTrack),
        GE(CLSID_DirectMusicSong),
        GE(CLSID_DirectMusicStyle),
        GE(CLSID_DirectMusicStyleTrack),
        GE(CLSID_DirectMusicSynth),
        GE(CLSID_DirectMusicSynthSink),
        GE(CLSID_DirectMusicSysExTrack),
        GE(CLSID_DirectMusicTemplate),
        GE(CLSID_DirectMusicTempoTrack),
        GE(CLSID_DirectMusicTimeSigTrack),
        GE(CLSID_DirectMusicWaveTrack),
        GE(CLSID_DirectSoundWave),
        /* IIDs */
        GE(IID_IDirectMusic),
        GE(IID_IDirectMusic2),
        GE(IID_IDirectMusic8),
        GE(IID_IDirectMusicAudioPath),
        GE(IID_IDirectMusicBand),
        GE(IID_IDirectMusicBuffer),
        GE(IID_IDirectMusicChordMap),
        GE(IID_IDirectMusicCollection),
        GE(IID_IDirectMusicComposer),
        GE(IID_IDirectMusicContainer),
        GE(IID_IDirectMusicDownload),
        GE(IID_IDirectMusicDownloadedInstrument),
        GE(IID_IDirectMusicGetLoader),
        GE(IID_IDirectMusicGraph),
        GE(IID_IDirectMusicInstrument),
        GE(IID_IDirectMusicLoader),
        GE(IID_IDirectMusicLoader8),
        GE(IID_IDirectMusicObject),
        GE(IID_IDirectMusicPatternTrack),
        GE(IID_IDirectMusicPerformance),
        GE(IID_IDirectMusicPerformance2),
        GE(IID_IDirectMusicPerformance8),
        GE(IID_IDirectMusicPort),
        GE(IID_IDirectMusicPortDownload),
        GE(IID_IDirectMusicScript),
        GE(IID_IDirectMusicSegment),
        GE(IID_IDirectMusicSegment2),
        GE(IID_IDirectMusicSegment8),
        GE(IID_IDirectMusicSegmentState),
        GE(IID_IDirectMusicSegmentState8),
        GE(IID_IDirectMusicStyle),
        GE(IID_IDirectMusicStyle8),
        GE(IID_IDirectMusicSynth),
        GE(IID_IDirectMusicSynth8),
        GE(IID_IDirectMusicSynthSink),
        GE(IID_IDirectMusicThru),
        GE(IID_IDirectMusicTool),
        GE(IID_IDirectMusicTool8),
        GE(IID_IDirectMusicTrack),
        GE(IID_IDirectMusicTrack8),
        GE(IID_IUnknown),
        GE(IID_IPersistStream),
        GE(IID_IStream),
        GE(IID_IClassFactory),
        /* GUIDs */
        GE(GUID_DirectMusicAllTypes),
        GE(GUID_NOTIFICATION_CHORD),
        GE(GUID_NOTIFICATION_COMMAND),
        GE(GUID_NOTIFICATION_MEASUREANDBEAT),
        GE(GUID_NOTIFICATION_PERFORMANCE),
        GE(GUID_NOTIFICATION_RECOMPOSE),
        GE(GUID_NOTIFICATION_SEGMENT),
        GE(GUID_BandParam),
        GE(GUID_ChordParam),
        GE(GUID_CommandParam),
        GE(GUID_CommandParam2),
        GE(GUID_CommandParamNext),
        GE(GUID_IDirectMusicBand),
        GE(GUID_IDirectMusicChordMap),
        GE(GUID_IDirectMusicStyle),
        GE(GUID_MuteParam),
        GE(GUID_Play_Marker),
        GE(GUID_RhythmParam),
        GE(GUID_TempoParam),
        GE(GUID_TimeSignature),
        GE(GUID_Valid_Start_Time),
        GE(GUID_Clear_All_Bands),
        GE(GUID_ConnectToDLSCollection),
        GE(GUID_Disable_Auto_Download),
        GE(GUID_DisableTempo),
        GE(GUID_DisableTimeSig),
        GE(GUID_Download),
        GE(GUID_DownloadToAudioPath),
        GE(GUID_Enable_Auto_Download),
        GE(GUID_EnableTempo),
        GE(GUID_EnableTimeSig),
        GE(GUID_IgnoreBankSelectForGM),
        GE(GUID_SeedVariations),
        GE(GUID_StandardMIDIFile),
        GE(GUID_Unload),
        GE(GUID_UnloadFromAudioPath),
        GE(GUID_Variations),
        GE(GUID_PerfMasterTempo),
        GE(GUID_PerfMasterVolume),
        GE(GUID_PerfMasterGrooveLevel),
        GE(GUID_PerfAutoDownload),
        GE(GUID_DefaultGMCollection),
        GE(GUID_Synth_Default),
        GE(GUID_Buffer_Reverb),
        GE(GUID_Buffer_EnvReverb),
        GE(GUID_Buffer_Stereo),
        GE(GUID_Buffer_3D_Dry),
        GE(GUID_Buffer_Mono),
        GE(GUID_DMUS_PROP_GM_Hardware),
        GE(GUID_DMUS_PROP_GS_Capable),
        GE(GUID_DMUS_PROP_GS_Hardware),
        GE(GUID_DMUS_PROP_DLS1),
        GE(GUID_DMUS_PROP_DLS2),
        GE(GUID_DMUS_PROP_Effects),
        GE(GUID_DMUS_PROP_INSTRUMENT2),
        GE(GUID_DMUS_PROP_LegacyCaps),
        GE(GUID_DMUS_PROP_MemorySize),
        GE(GUID_DMUS_PROP_SampleMemorySize),
        GE(GUID_DMUS_PROP_SamplePlaybackRate),
        GE(GUID_DMUS_PROP_SetSynthSink),
        GE(GUID_DMUS_PROP_SinkUsesDSound),
        GE(GUID_DMUS_PROP_SynthSink_DSOUND),
        GE(GUID_DMUS_PROP_SynthSink_WAVE),
        GE(GUID_DMUS_PROP_Volume),
        GE(GUID_DMUS_PROP_WavesReverb),
        GE(GUID_DMUS_PROP_WriteLatency),
        GE(GUID_DMUS_PROP_WritePeriod),
        GE(GUID_DMUS_PROP_XG_Capable),
        GE(GUID_DMUS_PROP_XG_Hardware)
    };

    unsigned int i;

        if (!id) return "(null)";

    for (i = 0; i < ARRAY_SIZE(guids); i++) {
        if (IsEqualGUID(id, guids[i].guid))
            return guids[i].name;
    }
    /* if we didn't find it, act like standard debugstr_guid */ 
    return debugstr_guid(id);
}   

/* generic flag-dumping function */
static const char* debugstr_flags (DWORD flags, const flag_info* names, size_t num_names){
    char buffer[128] = "", *ptr = &buffer[0];
    unsigned int i;
    int size = sizeof(buffer);
    
    for (i=0; i < num_names; i++)
    {
        if ((flags & names[i].val) ||   /* standard flag*/
            ((!flags) && (!names[i].val))) { /* zero value only */
                int cnt = snprintf(ptr, size, "%s ", names[i].name);
                if (cnt < 0 || cnt >= size) break;
                size -= cnt;
                ptr += cnt;
        }
    }
    
    return wine_dbg_sprintf("%s", buffer);
}

/* dump DMUS_OBJ flags */
static const char *debugstr_DMUS_OBJ_FLAGS (DWORD flagmask) {
    static const flag_info flags[] = {
        FE(DMUS_OBJ_OBJECT),
        FE(DMUS_OBJ_CLASS),
        FE(DMUS_OBJ_NAME),
        FE(DMUS_OBJ_CATEGORY),
        FE(DMUS_OBJ_FILENAME),
        FE(DMUS_OBJ_FULLPATH),
        FE(DMUS_OBJ_URL),
        FE(DMUS_OBJ_VERSION),
        FE(DMUS_OBJ_DATE),
        FE(DMUS_OBJ_LOADED),
        FE(DMUS_OBJ_MEMORY),
        FE(DMUS_OBJ_STREAM)
    };
    return debugstr_flags(flagmask, flags, ARRAY_SIZE(flags));
}

/* Dump whole DMUS_OBJECTDESC struct */
void dump_DMUS_OBJECTDESC(LPDMUS_OBJECTDESC desc)
{
    TRACE("DMUS_OBJECTDESC (%p):\n", desc);
    TRACE(" - dwSize = %d\n", desc->dwSize);
    TRACE(" - dwValidData = %s\n", debugstr_DMUS_OBJ_FLAGS (desc->dwValidData));
    if (desc->dwValidData & DMUS_OBJ_CLASS)    TRACE(" - guidClass = %s\n", debugstr_dmguid(&desc->guidClass));
    if (desc->dwValidData & DMUS_OBJ_OBJECT)   TRACE(" - guidObject = %s\n", debugstr_guid(&desc->guidObject));
    if (desc->dwValidData & DMUS_OBJ_DATE)     TRACE(" - ftDate = FIXME\n");
    if (desc->dwValidData & DMUS_OBJ_VERSION)  TRACE(" - vVersion = %s\n", debugstr_dmversion(&desc->vVersion));
    if (desc->dwValidData & DMUS_OBJ_NAME)     TRACE(" - wszName = %s\n", debugstr_w(desc->wszName));
    if (desc->dwValidData & DMUS_OBJ_CATEGORY) TRACE(" - wszCategory = %s\n", debugstr_w(desc->wszCategory));
    if (desc->dwValidData & DMUS_OBJ_FILENAME) TRACE(" - wszFileName = %s\n", debugstr_w(desc->wszFileName));
    if (desc->dwValidData & DMUS_OBJ_MEMORY)   TRACE(" - llMemLength = 0x%s\n  - pbMemData = %p\n",
                                                     wine_dbgstr_longlong(desc->llMemLength), desc->pbMemData);
    if (desc->dwValidData & DMUS_OBJ_STREAM)   TRACE(" - pStream = %p\n", desc->pStream);
}

/* Dump DMUS_PORTPARAMS flags */
static const char* debugstr_DMUS_PORTPARAMS_FLAGS(DWORD flagmask)
{
    static const flag_info flags[] = {
        FE(DMUS_PORTPARAMS_VOICES),
        FE(DMUS_PORTPARAMS_CHANNELGROUPS),
        FE(DMUS_PORTPARAMS_AUDIOCHANNELS),
        FE(DMUS_PORTPARAMS_SAMPLERATE),
        FE(DMUS_PORTPARAMS_EFFECTS),
        FE(DMUS_PORTPARAMS_SHARE)
    };
    return debugstr_flags(flagmask, flags, ARRAY_SIZE(flags));
}

/* Dump whole DMUS_PORTPARAMS struct */
void dump_DMUS_PORTPARAMS(LPDMUS_PORTPARAMS params)
{
    TRACE("DMUS_PORTPARAMS (%p):\n", params);
    TRACE(" - dwSize = %d\n", params->dwSize);
    TRACE(" - dwValidParams = %s\n", debugstr_DMUS_PORTPARAMS_FLAGS(params->dwValidParams));
    if (params->dwValidParams & DMUS_PORTPARAMS_VOICES)        TRACE(" - dwVoices = %u\n", params->dwVoices);
    if (params->dwValidParams & DMUS_PORTPARAMS_CHANNELGROUPS) TRACE(" - dwChannelGroup = %u\n", params->dwChannelGroups);
    if (params->dwValidParams & DMUS_PORTPARAMS_AUDIOCHANNELS) TRACE(" - dwAudioChannels = %u\n", params->dwAudioChannels);
    if (params->dwValidParams & DMUS_PORTPARAMS_SAMPLERATE)    TRACE(" - dwSampleRate = %u\n", params->dwSampleRate);
    if (params->dwValidParams & DMUS_PORTPARAMS_EFFECTS)       TRACE(" - dwEffectFlags = %x\n", params->dwEffectFlags);
    if (params->dwValidParams & DMUS_PORTPARAMS_SHARE)         TRACE(" - fShare = %u\n", params->fShare);
}