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