Home | History | Annotate | Download | only in include
      1 #undef INTERFACE
      2 /*
      3  *  DirectMusic Software Synth Definitions
      4  *
      5  *  Copyright (C) 2003-2004 Rok Mandeljc
      6  *
      7  *  This program is free software; you can redistribute it and/or
      8  *  modify it under the terms of the GNU Lesser General Public
      9  *  License as published by the Free Software Foundation; either
     10  *  version 2.1 of the License, or (at your option) any later version.
     11  *
     12  *  This program is distributed in the hope that it will be useful,
     13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
     14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     15  *  Lesser General Public License for more details.
     16  *
     17  *  You should have received a copy of the GNU Lesser General Public
     18  *  License along with this program; if not, write to the Free Software
     19  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
     20  */
     21 
     22 #ifndef __WINE_DMUSIC_SOFTWARESYNTH_H
     23 #define __WINE_DMUSIC_SOFTWARESYNTH_H
     24 
     25 #include <dmusicc.h>
     26 
     27 /*****************************************************************************
     28  * Registry path
     29  */
     30 #define REGSTR_PATH_SOFTWARESYNTHS "Software\\Microsoft\\DirectMusic\\SoftwareSynths"
     31 
     32 
     33 /*****************************************************************************
     34  * Predeclare the interfaces
     35  */
     36 /* IIDs */
     37 DEFINE_GUID(IID_IDirectMusicSynth,     0x09823661,0x5c85,0x11d2,0xaf,0xa6,0x00,0xaa,0x00,0x24,0xd8,0xb6);
     38 DEFINE_GUID(IID_IDirectMusicSynth8,    0x53cab625,0x2711,0x4c9f,0x9d,0xe7,0x1b,0x7f,0x92,0x5f,0x6f,0xc8);
     39 DEFINE_GUID(IID_IDirectMusicSynthSink, 0x09823663,0x5c85,0x11d2,0xaf,0xa6,0x00,0xaa,0x00,0x24,0xd8,0xb6);
     40 
     41 /* typedef definitions */
     42 typedef struct IDirectMusicSynth *LPDIRECTMUSICSYNTH;
     43 typedef struct IDirectMusicSynth8 *LPDIRECTMUSICSYNTH8;
     44 typedef struct IDirectMusicSynthSink *LPDIRECTMUSICSYNTHSINK;
     45 
     46 /* GUIDs - property set */
     47 DEFINE_GUID(GUID_DMUS_PROP_SetSynthSink,   0x0a3a5ba5,0x37b6,0x11d2,0xb9,0xf9,0x00,0x00,0xf8,0x75,0xac,0x12);
     48 DEFINE_GUID(GUID_DMUS_PROP_SinkUsesDSound, 0xbe208857,0x8952,0x11d2,0xba,0x1c,0x00,0x00,0xf8,0x75,0xac,0x12);
     49 
     50 
     51 /*****************************************************************************
     52  * Flags
     53  */
     54 #define REFRESH_F_LASTBUFFER        0x1
     55 
     56 
     57 /*****************************************************************************
     58  * Structures
     59  */
     60 #ifndef _DMUS_VOICE_STATE_DEFINED
     61 #define _DMUS_VOICE_STATE_DEFINED
     62 
     63 /* typedef definition */
     64 typedef struct _DMUS_VOICE_STATE DMUS_VOICE_STATE, *LPDMUS_VOICE_STATE;
     65 
     66 /* actual structure */
     67 struct _DMUS_VOICE_STATE {
     68 	WINBOOL         bExists;
     69 	SAMPLE_POSITION spPosition;
     70 };
     71 #endif /* _DMUS_VOICE_STATE_DEFINED */
     72 
     73 
     74 /*****************************************************************************
     75  * IDirectMusicSynth interface
     76  */
     77 #define INTERFACE IDirectMusicSynth
     78 DECLARE_INTERFACE_(IDirectMusicSynth,IUnknown)
     79 {
     80     /*** IUnknown methods ***/
     81     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
     82     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
     83     STDMETHOD_(ULONG,Release)(THIS) PURE;
     84     /*** IDirectMusicSynth methods ***/
     85     STDMETHOD(Open)(THIS_ LPDMUS_PORTPARAMS pPortParams) PURE;
     86     STDMETHOD(Close)(THIS) PURE;
     87     STDMETHOD(SetNumChannelGroups)(THIS_ DWORD dwGroups) PURE;
     88     STDMETHOD(Download)(THIS_ LPHANDLE phDownload, LPVOID pvData, LPBOOL pbFree) PURE;
     89     STDMETHOD(Unload)(THIS_ HANDLE hDownload, HRESULT (CALLBACK* lpFreeHandle)(HANDLE,HANDLE), HANDLE hUserData) PURE;
     90     STDMETHOD(PlayBuffer)(THIS_ REFERENCE_TIME rt, LPBYTE pbBuffer, DWORD cbBuffer) PURE;
     91     STDMETHOD(GetRunningStats)(THIS_ LPDMUS_SYNTHSTATS pStats) PURE;
     92     STDMETHOD(GetPortCaps)(THIS_ LPDMUS_PORTCAPS pCaps) PURE;
     93     STDMETHOD(SetMasterClock)(THIS_ IReferenceClock *pClock) PURE;
     94     STDMETHOD(GetLatencyClock)(THIS_ IReferenceClock **ppClock) PURE;
     95     STDMETHOD(Activate)(THIS_ WINBOOL fEnable) PURE;
     96     STDMETHOD(SetSynthSink)(THIS_ struct IDirectMusicSynthSink *pSynthSink) PURE;
     97     STDMETHOD(Render)(THIS_ short *pBuffer, DWORD dwLength, LONGLONG llPosition) PURE;
     98     STDMETHOD(SetChannelPriority)(THIS_ DWORD dwChannelGroup, DWORD dwChannel, DWORD dwPriority) PURE;
     99     STDMETHOD(GetChannelPriority)(THIS_ DWORD dwChannelGroup, DWORD dwChannel, LPDWORD pdwPriority) PURE;
    100     STDMETHOD(GetFormat)(THIS_ LPWAVEFORMATEX pWaveFormatEx, LPDWORD pdwWaveFormatExSiz) PURE;
    101     STDMETHOD(GetAppend)(THIS_ DWORD *pdwAppend) PURE;
    102 };
    103 #undef INTERFACE
    104 
    105 #if !defined(__cplusplus) || defined(CINTERFACE)
    106 /*** IUnknown methods ***/
    107 #define IDirectMusicSynth_QueryInterface(p,a,b)       (p)->lpVtbl->QueryInterface(p,a,b)
    108 #define IDirectMusicSynth_AddRef(p)                   (p)->lpVtbl->AddRef(p)
    109 #define IDirectMusicSynth_Release(p)                  (p)->lpVtbl->Release(p)
    110 /*** IDirectMusicSynth methods ***/
    111 #define IDirectMusicSynth_Open(p,a)                   (p)->lpVtbl->Open(p,a)
    112 #define IDirectMusicSynth_Close(p)                    (p)->lpVtbl->Close(p)
    113 #define IDirectMusicSynth_SetNumChannelGroups(p,a)    (p)->lpVtbl->SetNumChannelGroups(p,a)
    114 #define IDirectMusicSynth_Download(p,a,b,c)           (p)->lpVtbl->Download(p,a,b,c)
    115 #define IDirectMusicSynth_Unload(p,a,b,c)             (p)->lpVtbl->Unload(p,a,b,c)
    116 #define IDirectMusicSynth_PlayBuffer(p,a,b,c)         (p)->lpVtbl->PlayBuffer(p,a,b,c)
    117 #define IDirectMusicSynth_GetRunningStats(p,a)        (p)->lpVtbl->GetRunningStats(p,a)
    118 #define IDirectMusicSynth_GetPortCaps(p,a)            (p)->lpVtbl->GetPortCaps(p,a)
    119 #define IDirectMusicSynth_SetMasterClock(p,a)         (p)->lpVtbl->SetMasterClock(p,a)
    120 #define IDirectMusicSynth_GetLatencyClock(p,a)        (p)->lpVtbl->GetLatencyClock(p,a)
    121 #define IDirectMusicSynth_Activate(p,a)               (p)->lpVtbl->Activate(p,a)
    122 #define IDirectMusicSynth_SetSynthSink(p,a)           (p)->lpVtbl->SetSynthSink(p,a)
    123 #define IDirectMusicSynth_Render(p,a,b,c)             (p)->lpVtbl->Render(p,a,b,c)
    124 #define IDirectMusicSynth_SetChannelPriority(p,a,b,c) (p)->lpVtbl->SetChannelPriority(p,a,b,c)
    125 #define IDirectMusicSynth_GetChannelPriority(p,a,b,c) (p)->lpVtbl->GetChannelPriority(p,a,b,c)
    126 #define IDirectMusicSynth_GetFormat(p,a,b)            (p)->lpVtbl->GetFormat(p,a,b)
    127 #define IDirectMusicSynth_GetAppend(p,a)              (p)->lpVtbl->GetAppend(p,a)
    128 #endif
    129 
    130 
    131 /*****************************************************************************
    132  * IDirectMusicSynth8 interface
    133  */
    134 #define INTERFACE IDirectMusicSynth8
    135 DECLARE_INTERFACE_(IDirectMusicSynth8,IDirectMusicSynth)
    136 {
    137     /*** IUnknown methods ***/
    138     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
    139     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
    140     STDMETHOD_(ULONG,Release)(THIS) PURE;
    141     /*** IDirectMusicSynth methods ***/
    142     STDMETHOD(Open)(THIS_ LPDMUS_PORTPARAMS pPortParams) PURE;
    143     STDMETHOD(Close)(THIS) PURE;
    144     STDMETHOD(SetNumChannelGroups)(THIS_ DWORD dwGroups) PURE;
    145     STDMETHOD(Download)(THIS_ LPHANDLE phDownload, LPVOID pvData, LPBOOL pbFree) PURE;
    146     STDMETHOD(Unload)(THIS_ HANDLE hDownload, HRESULT (CALLBACK* lpFreeHandle)(HANDLE,HANDLE), HANDLE hUserData) PURE;
    147     STDMETHOD(PlayBuffer)(THIS_ REFERENCE_TIME rt, LPBYTE pbBuffer, DWORD cbBuffer) PURE;
    148     STDMETHOD(GetRunningStats)(THIS_ LPDMUS_SYNTHSTATS pStats) PURE;
    149     STDMETHOD(GetPortCaps)(THIS_ LPDMUS_PORTCAPS pCaps) PURE;
    150     STDMETHOD(SetMasterClock)(THIS_ IReferenceClock *pClock) PURE;
    151     STDMETHOD(GetLatencyClock)(THIS_ IReferenceClock **ppClock) PURE;
    152     STDMETHOD(Activate)(THIS_ WINBOOL fEnable) PURE;
    153     STDMETHOD(SetSynthSink)(THIS_ struct IDirectMusicSynthSink *pSynthSink) PURE;
    154     STDMETHOD(Render)(THIS_ short *pBuffer, DWORD dwLength, LONGLONG llPosition) PURE;
    155     STDMETHOD(SetChannelPriority)(THIS_ DWORD dwChannelGroup, DWORD dwChannel, DWORD dwPriority) PURE;
    156     STDMETHOD(GetChannelPriority)(THIS_ DWORD dwChannelGroup, DWORD dwChannel, LPDWORD pdwPriority) PURE;
    157     STDMETHOD(GetFormat)(THIS_ LPWAVEFORMATEX pWaveFormatEx, LPDWORD pdwWaveFormatExSiz) PURE;
    158     STDMETHOD(GetAppend)(THIS_ DWORD *pdwAppend) PURE;
    159     /*** IDirectMusicSynth8 methods ***/
    160     STDMETHOD(PlayVoice)(THIS_ REFERENCE_TIME rt, DWORD dwVoiceId, DWORD dwChannelGroup, DWORD dwChannel, DWORD dwDLId, LONG prPitch, LONG vrVolume, SAMPLE_TIME stVoiceStart, SAMPLE_TIME stLoopStart, SAMPLE_TIME stLoopEnd) PURE;
    161     STDMETHOD(StopVoice)(THIS_ REFERENCE_TIME rt, DWORD dwVoiceId) PURE;
    162     STDMETHOD(GetVoiceState)(THIS_ DWORD dwVoice[], DWORD cbVoice, DMUS_VOICE_STATE dwVoiceState[]) PURE;
    163     STDMETHOD(Refresh)(THIS_ DWORD dwDownloadID, DWORD dwFlags) PURE;
    164     STDMETHOD(AssignChannelToBuses)(THIS_ DWORD dwChannelGroup, DWORD dwChannel, LPDWORD pdwBuses, DWORD cBuses) PURE;
    165 };
    166 #undef INTERFACE
    167 
    168 #if !defined(__cplusplus) || defined(CINTERFACE)
    169 /*** IUnknown methods ***/
    170 #define IDirectMusicSynth8_QueryInterface(p,a,b)            (p)->lpVtbl->QueryInterface(p,a,b)
    171 #define IDirectMusicSynth8_AddRef(p)                        (p)->lpVtbl->AddRef(p)
    172 #define IDirectMusicSynth8_Release(p)                       (p)->lpVtbl->Release(p)
    173 /*** IDirectMusicSynth methods ***/
    174 #define IDirectMusicSynth8_Open(p,a)                        (p)->lpVtbl->Open(p,a)
    175 #define IDirectMusicSynth8_Close(p)                         (p)->lpVtbl->Close(p)
    176 #define IDirectMusicSynth8_SetNumChannelGroups(p,a)         (p)->lpVtbl->SetNumChannelGroups(p,a)
    177 #define IDirectMusicSynth8_Download(p,a,b,c)                (p)->lpVtbl->Download(p,a,b,c)
    178 #define IDirectMusicSynth8_Unload(p,a,b,c)                  (p)->lpVtbl->Unload(p,a,b,c)
    179 #define IDirectMusicSynth8_PlayBuffer(p,a,b,c)              (p)->lpVtbl->PlayBuffer(p,a,b,c)
    180 #define IDirectMusicSynth8_GetRunningStats(p,a)             (p)->lpVtbl->GetRunningStats(p,a)
    181 #define IDirectMusicSynth8_GetPortCaps(p,a)                 (p)->lpVtbl->GetPortCaps(p,a)
    182 #define IDirectMusicSynth8_SetMasterClock(p,a)              (p)->lpVtbl->SetMasterClock(p,a)
    183 #define IDirectMusicSynth8_GetLatencyClock(p,a)             (p)->lpVtbl->GetLatencyClock(p,a)
    184 #define IDirectMusicSynth8_Activate(p,a)                    (p)->lpVtbl->Activate(p,a)
    185 #define IDirectMusicSynth8_SetSynthSink(p,a)                (p)->lpVtbl->SetSynthSink(p,a)
    186 #define IDirectMusicSynth8_Render(p,a,b,c)                  (p)->lpVtbl->Render(p,a,b,c)
    187 #define IDirectMusicSynth8_SetChannelPriority(p,a,b,c)      (p)->lpVtbl->SetChannelPriority(p,a,b,c)
    188 #define IDirectMusicSynth8_GetChannelPriority(p,a,b,c)      (p)->lpVtbl->GetChannelPriority(p,a,b,c)
    189 #define IDirectMusicSynth8_GetFormat(p,a,b)                 (p)->lpVtbl->GetFormat(p,a,b)
    190 #define IDirectMusicSynth8_GetAppend(p,a)                   (p)->lpVtbl->GetAppend(p,a)
    191 /*** IDirectMusicSynth8 methods ***/
    192 #define IDirectMusicSynth8_PlayVoice(p,a,b,c,d,e,f,g,h,i,j) (p)->lpVtbl->PlayVoice(p,a,b,c,d,e,f,g,h,i,j)
    193 #define IDirectMusicSynth8_StopVoice(p,a,b)                 (p)->lpVtbl->StopVoice(p,a,b)
    194 #define IDirectMusicSynth8_GetVoiceState(p,a,b,c)           (p)->lpVtbl->GetVoiceState(p,a,b,c)
    195 #define IDirectMusicSynth8_Refresh(p,a,b)                   (p)->lpVtbl->Refresh(p,a,b)
    196 #define IDirectMusicSynth8_AssignChannelToBuses(p,a,b,c,d)  (p)->lpVtbl->AssignChannelToBuses(p,a,b,c,d)
    197 #endif
    198 
    199 
    200 /*****************************************************************************
    201  * IDirectMusicSynthSink interface
    202  */
    203 #define INTERFACE IDirectMusicSynthSink
    204 DECLARE_INTERFACE_(IDirectMusicSynthSink,IUnknown)
    205 {
    206     /*** IUnknown methods ***/
    207     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
    208     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
    209     STDMETHOD_(ULONG,Release)(THIS) PURE;
    210     /*** IDirectMusicSynthSink methods ***/
    211     STDMETHOD(Init)(THIS_ IDirectMusicSynth *pSynth) PURE;
    212     STDMETHOD(SetMasterClock)(THIS_ IReferenceClock *pClock) PURE;
    213     STDMETHOD(GetLatencyClock)(THIS_ IReferenceClock **ppClock) PURE;
    214     STDMETHOD(Activate)(THIS_ WINBOOL fEnable) PURE;
    215     STDMETHOD(SampleToRefTime)(THIS_ LONGLONG llSampleTime, REFERENCE_TIME *prfTime) PURE;
    216     STDMETHOD(RefTimeToSample)(THIS_ REFERENCE_TIME rfTime, LONGLONG *pllSampleTime) PURE;
    217     STDMETHOD(SetDirectSound)(THIS_ LPDIRECTSOUND pDirectSound, LPDIRECTSOUNDBUFFER pDirectSoundBuffer) PURE;
    218     STDMETHOD(GetDesiredBufferSize)(THIS_ LPDWORD pdwBufferSizeInSamples) PURE;
    219 };
    220 #undef INTERFACE
    221 
    222 #if !defined(__cplusplus) || defined(CINTERFACE)
    223 /*** IUnknown methods ***/
    224 #define IDirectMusicSynthSink_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
    225 #define IDirectMusicSynthSink_AddRef(p)                  (p)->lpVtbl->AddRef(p)
    226 #define IDirectMusicSynthSink_Release(p)                 (p)->lpVtbl->Release(p)
    227 /*** IDirectMusicSynth methods ***/
    228 #define IDirectMusicSynthSink_Init(p,a)                  (p)->lpVtbl->Init(p,a)
    229 #define IDirectMusicSynthSink_SetMasterClock(p,a)        (p)->lpVtbl->SetMasterClock(p,a)
    230 #define IDirectMusicSynthSink_GetLatencyClock(p,a)       (p)->lpVtbl->GetLatencyClock(p,a)
    231 #define IDirectMusicSynthSink_Activate(p,a)              (p)->lpVtbl->Activate(p,a)
    232 #define IDirectMusicSynthSink_SampleToRefTime(p,a,b)     (p)->lpVtbl->SampleToRefTime(p,a,b)
    233 #define IDirectMusicSynthSink_RefTimeToSample(p,a,b)     (p)->lpVtbl->RefTimeToSample(p,a,b)
    234 #define IDirectMusicSynthSink_SetDirectSound(p,a,b)      (p)->lpVtbl->SetDirectSound(p,a,b)
    235 #define IDirectMusicSynthSink_GetDesiredBufferSize(p,a)  (p)->lpVtbl->GetDesiredBufferSize(p,a)
    236 #endif
    237 
    238 #endif /* __WINE_DMUSIC_SOFTWARESYNTH_H */
    239