2 * DirectMusic Performance Layer Plugins API
4 * Copyright (C) 2003-2004 Rok Mandeljc
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
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
14 * GNU Library General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 #ifndef __WINE_DMUSIC_PLUGIN_H
22 #define __WINE_DMUSIC_PLUGIN_H
26 #endif /* __WINESRC__ */
37 /*****************************************************************************
40 #define DMUS_REGSTR_PATH_TOOLS "Software\\Microsoft\\DirectMusic\\Tools"
43 /*****************************************************************************
44 * Predeclare the interfaces
47 DEFINE_GUID(CLSID_DirectMusicBandTrack, 0xd2ac2894,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
48 DEFINE_GUID(CLSID_DirectMusicChordTrack, 0xd2ac288b,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
49 DEFINE_GUID(CLSID_DirectMusicChordMapTrack, 0xd2ac2896,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
50 DEFINE_GUID(CLSID_DirectMusicCommandTrack, 0xd2ac288c,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
51 DEFINE_GUID(CLSID_DirectMusicLyricsTrack, 0x995c1cf5,0x54ff,0x11d3,0x8b,0xda,0x00,0x60,0x08,0x93,0xb1,0xb6);
52 DEFINE_GUID(CLSID_DirectMusicMarkerTrack, 0x55a8fd00,0x4288,0x11d3,0x9b,0xd1,0x8a,0x0d,0x61,0xc8,0x88,0x35);
53 DEFINE_GUID(CLSID_DirectMusicMotifTrack, 0xd2ac288e,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
54 DEFINE_GUID(CLSID_DirectMusicMuteTrack, 0xd2ac2898,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
55 DEFINE_GUID(CLSID_DirectMusicParamControlTrack, 0x4be0537b,0x5c19,0x11d3,0x8b,0xdc,0x00,0x60,0x08,0x93,0xb1,0xb6);
56 DEFINE_GUID(CLSID_DirectMusicScriptTrack, 0x4108fa85,0x3586,0x11d3,0x8b,0xd7,0x00,0x60,0x08,0x93,0xb1,0xb6);
57 DEFINE_GUID(CLSID_DirectMusicSegmentTriggerTrack, 0xbae4d665,0x4ea1,0x11d3,0x8b,0xda,0x00,0x60,0x08,0x93,0xb1,0xb6);
58 DEFINE_GUID(CLSID_DirectMusicSeqTrack, 0xd2ac2886,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
59 DEFINE_GUID(CLSID_DirectMusicSignPostTrack, 0xf17e8672,0xc3b4,0x11d1,0x87,0x0b,0x00,0x60,0x08,0x93,0xb1,0xbd);
60 DEFINE_GUID(CLSID_DirectMusicStyleTrack, 0xd2ac288d,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
61 DEFINE_GUID(CLSID_DirectMusicSysExTrack, 0xd2ac2887,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
62 DEFINE_GUID(CLSID_DirectMusicTempoTrack, 0xd2ac2885,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
63 DEFINE_GUID(CLSID_DirectMusicTimeSigTrack, 0xd2ac2888,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
64 DEFINE_GUID(CLSID_DirectMusicWaveTrack, 0xeed36461,0x9ea5,0x11d3,0x9b,0xd1,0x00,0x80,0xc7,0x15,0x0a,0x74);
65 /* MS doesn't support this in DX 9.0 and newer... but there's no harm in keeping it around */
66 DEFINE_GUID(CLSID_DirectMusicMelodyFormulationTrack, 0xb0684266,0xb57f,0x11d2,0x97,0xf9,0x00,0xc0,0x4f,0xa3,0x6e,0x58);
69 DEFINE_GUID(IID_IDirectMusicTool, 0xd2ac28ba,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
70 DEFINE_GUID(IID_IDirectMusicTool8, 0x0e674303,0x3b05,0x11d3,0x9b,0xd1,0xf9,0xe7,0xf0,0xa0,0x15,0x36);
71 DEFINE_GUID(IID_IDirectMusicTrack, 0xf96029a1,0x4282,0x11d2,0x87,0x17,0x00,0x60,0x08,0x93,0xb1,0xbd);
72 DEFINE_GUID(IID_IDirectMusicTrack8, 0x0e674304,0x3b05,0x11d3,0x9b,0xd1,0xf9,0xe7,0xf0,0xa0,0x15,0x36);
74 /* typedef definitions */
75 typedef struct IDirectMusicTrack *LPDIRECTMUSICTRACK;
76 typedef struct IDirectMusicTrack8 *LPDIRECTMUSICTRACK8;
77 typedef struct IDirectMusicTool *LPDIRECTMUSICTOOL;
78 typedef struct IDirectMusicTool8 *LPDIRECTMUSICTOOL8;
79 /* these are from dmusici.h and are needed here */
80 typedef struct IDirectMusicPerformance *LPDIRECTMUSICPERFORMANCE;
81 typedef struct IDirectMusicPerformance8 *LPDIRECTMUSICPERFORMANCE8;
82 typedef struct IDirectMusicSegment *LPDIRECTMUSICSEGMENT;
83 typedef struct IDirectMusicSegment8 *LPDIRECTMUSICSEGMENT8;
84 typedef struct IDirectMusicSegmentState *LPDIRECTMUSICSEGMENTSTATE;
85 typedef struct IDirectMusicSegmentState8 *LPDIRECTMUSICSEGMENTSTATE8;
86 typedef struct IDirectMusicGraph *LPDIRECTMUSICGRAPH;
87 typedef struct IDirectMusicGraph IDirectMusicGraph8, *LPDIRECTMUSICGRAPH8;
90 /*****************************************************************************
93 typedef struct _DMUS_PMSG DMUS_PMSG;
94 typedef long MUSIC_TIME;
97 /*****************************************************************************
100 #define DMUS_TRACK_PARAMF_CLOCK 0x1
102 /*****************************************************************************
105 /* typedef definitions */
106 typedef enum enumDMUS_TRACKF_FLAGS DMUS_TRACKF_FLAGS;
108 /* actual enumerations */
109 enum enumDMUS_TRACKF_FLAGS {
110 DMUS_TRACKF_SEEK = 0x001,
111 DMUS_TRACKF_LOOP = 0x002,
112 DMUS_TRACKF_START = 0x004,
113 DMUS_TRACKF_FLUSH = 0x008,
114 DMUS_TRACKF_DIRTY = 0x010,
115 DMUS_TRACKF_NOTIFY_OFF = 0x020,
116 DMUS_TRACKF_PLAY_OFF = 0x040,
117 DMUS_TRACKF_LOOPEND = 0x080,
118 DMUS_TRACKF_STOP = 0x100,
119 DMUS_TRACKF_RECOMPOSE = 0x200,
120 DMUS_TRACKF_CLOCK = 0x400,
123 /*****************************************************************************
124 * IDirectMusicTool interface
126 #define INTERFACE IDirectMusicTool
127 DECLARE_INTERFACE_(IDirectMusicTool,IUnknown)
129 /*** IUnknown methods ***/
130 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
131 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
132 STDMETHOD_(ULONG,Release)(THIS) PURE;
133 /*** IDirectMusicTool methods ***/
134 STDMETHOD(Init)(THIS_ struct IDirectMusicGraph *pGraph) PURE;
135 STDMETHOD(GetMsgDeliveryType)(THIS_ DWORD *pdwDeliveryType) PURE;
136 STDMETHOD(GetMediaTypeArraySize)(THIS_ DWORD *pdwNumElements) PURE;
137 STDMETHOD(GetMediaTypes)(THIS_ DWORD **padwMediaTypes, DWORD dwNumElements) PURE;
138 STDMETHOD(ProcessPMsg)(THIS_ struct IDirectMusicPerformance *pPerf, DMUS_PMSG *pPMSG) PURE;
139 STDMETHOD(Flush)(THIS_ struct IDirectMusicPerformance *pPerf, DMUS_PMSG *pPMSG, REFERENCE_TIME rtTime) PURE;
143 #if !defined(__cplusplus) || defined(CINTERFACE)
144 /*** IUnknown methods ***/
145 #define IDirectMusicTool_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
146 #define IDirectMusicTool_AddRef(p) (p)->lpVtbl->AddRef(p)
147 #define IDirectMusicTool_Release(p) (p)->lpVtbl->Release(p)
148 /*** IDirectMusicTool methods ***/
149 #define IDirectMusicTool_Init(p,a) (p)->lpVtbl->Init(p,a)
150 #define IDirectMusicTool_GetMsgDeliveryType(p,a) (p)->lpVtbl->GetMsgDeliveryType(p,a)
151 #define IDirectMusicTool_GetMediaTypeArraySize(p,a) (p)->lpVtbl->GetMediaTypeArraySize(p,a)
152 #define IDirectMusicTool_GetMediaTypes(p,a,b) (p)->lpVtbl->GetMediaTypes(p,a,b)
153 #define IDirectMusicTool_ProcessPMsg(p,a,b) (p)->lpVtbl->ProcessPMsg(p,a,b)
154 #define IDirectMusicTool_Flush(p,a,b,c) (p)->lpVtbl->Flush(p,a,b,c)
158 /*****************************************************************************
159 * IDirectMusicTool8 interface
161 #define INTERFACE IDirectMusicTool8
162 DECLARE_INTERFACE_(IDirectMusicTool8,IDirectMusicTool)
164 /*** IUnknown methods ***/
165 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
166 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
167 STDMETHOD_(ULONG,Release)(THIS) PURE;
168 /*** IDirectMusicTool methods ***/
169 STDMETHOD(Init)(THIS_ struct IDirectMusicGraph *pGraph) PURE;
170 STDMETHOD(GetMsgDeliveryType)(THIS_ DWORD *pdwDeliveryType) PURE;
171 STDMETHOD(GetMediaTypeArraySize)(THIS_ DWORD *pdwNumElements) PURE;
172 STDMETHOD(GetMediaTypes)(THIS_ DWORD **padwMediaTypes, DWORD dwNumElements) PURE;
173 STDMETHOD(ProcessPMsg)(THIS_ struct IDirectMusicPerformance *pPerf, DMUS_PMSG *pPMSG) PURE;
174 STDMETHOD(Flush)(THIS_ struct IDirectMusicPerformance *pPerf, DMUS_PMSG *pPMSG, REFERENCE_TIME rtTime) PURE;
175 /*** IDirectMusicTool8 methods ***/
176 STDMETHOD(Clone)(THIS_ IDirectMusicTool **ppTool) PURE;
180 #if !defined(__cplusplus) || defined(CINTERFACE)
181 /*** IUnknown methods ***/
182 #define IDirectMusicTool8_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
183 #define IDirectMusicTool8_AddRef(p) (p)->lpVtbl->AddRef(p)
184 #define IDirectMusicTool8_Release(p) (p)->lpVtbl->Release(p)
185 /*** IDirectMusicTool methods ***/
186 #define IDirectMusicTool8_Init(p,a) (p)->lpVtbl->Init(p,a)
187 #define IDirectMusicTool8_GetMsgDeliveryType(p,a) (p)->lpVtbl->GetMsgDeliveryType(p,a)
188 #define IDirectMusicTool8_GetMediaTypeArraySize(p,a) (p)->lpVtbl->GetMediaTypeArraySize(p,a)
189 #define IDirectMusicTool8_GetMediaTypes(p,a,b) (p)->lpVtbl->GetMediaTypes(p,a,b)
190 #define IDirectMusicTool8_ProcessPMsg(p,a,b) (p)->lpVtbl->ProcessPMsg(p,a,b)
191 #define IDirectMusicTool8_Flush(p,a,b) (p)->lpVtbl->Flush(p,a,b)
192 /*** IDirectMusicTool8 methods ***/
193 #define IDirectMusicTool8_Clone(p,a) (p)->lpVtbl->Clone(p,a)
197 /*****************************************************************************
198 * IDirectMusicTrack interface
200 #define INTERFACE IDirectMusicTrack
201 DECLARE_INTERFACE_(IDirectMusicTrack,IUnknown)
203 /*** IUnknown methods ***/
204 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
205 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
206 STDMETHOD_(ULONG,Release)(THIS) PURE;
207 /*** IDirectMusicTrack methods ***/
208 STDMETHOD(Init)(THIS_ struct IDirectMusicSegment *pSegment) PURE;
209 STDMETHOD(InitPlay)(THIS_ struct IDirectMusicSegmentState *pSegmentState, struct IDirectMusicPerformance *pPerformance, void **ppStateData, DWORD dwVirtualTrackID, DWORD dwFlags) PURE;
210 STDMETHOD(EndPlay)(THIS_ void *pStateData) PURE;
211 STDMETHOD(Play)(THIS_ void *pStateData, MUSIC_TIME mtStart, MUSIC_TIME mtEnd, MUSIC_TIME mtOffset, DWORD dwFlags, struct IDirectMusicPerformance *pPerf, struct IDirectMusicSegmentState *pSegSt, DWORD dwVirtualID) PURE;
212 STDMETHOD(GetParam)(THIS_ REFGUID rguidType, MUSIC_TIME mtTime, MUSIC_TIME *pmtNext, void *pParam) PURE;
213 STDMETHOD(SetParam)(THIS_ REFGUID rguidType, MUSIC_TIME mtTime, void *pParam) PURE;
214 STDMETHOD(IsParamSupported)(THIS_ REFGUID rguidType) PURE;
215 STDMETHOD(AddNotificationType)(THIS_ REFGUID rguidNotificationType) PURE;
216 STDMETHOD(RemoveNotificationType)(THIS_ REFGUID rguidNotificationType) PURE;
217 STDMETHOD(Clone)(THIS_ MUSIC_TIME mtStart, MUSIC_TIME mtEnd, IDirectMusicTrack **ppTrack) PURE;
221 #if !defined(__cplusplus) || defined(CINTERFACE)
222 /*** IUnknown methods ***/
223 #define IDirectMusicTrack_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
224 #define IDirectMusicTrack_AddRef(p) (p)->lpVtbl->AddRef(p)
225 #define IDirectMusicTrack_Release(p) (p)->lpVtbl->Release(p)
226 /*** IDirectMusicTrack methods ***/
227 #define IDirectMusicTrack_Init(p,a) (p)->lpVtbl->Init(p,a)
228 #define IDirectMusicTrack_InitPlay(p,a,b,c,d,e) (p)->lpVtbl->InitPlay(p,a,b,c,d,e)
229 #define IDirectMusicTrack_EndPlay(p,a) (p)->lpVtbl->EndPlay(p,a)
230 #define IDirectMusicTrack_Play(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->Play(p,a,b,c,d,e,f,g,h)
231 #define IDirectMusicTrack_GetParam(p,a,b,c,d) (p)->lpVtbl->GetParam(p,a,b,c,d)
232 #define IDirectMusicTrack_SetParam(p,a,b,c) (p)->lpVtbl->SetParam(p,a,b,c)
233 #define IDirectMusicTrack_IsParamSupported(p,a) (p)->lpVtbl->IsParamSupported(p,a)
234 #define IDirectMusicTrack_AddNotificationType(p,a) (p)->lpVtbl->AddNotificationType(p,a)
235 #define IDirectMusicTrack_RemoveNotificationType(p,a) (p)->lpVtbl->RemoveNotificationType(p,a)
236 #define IDirectMusicTrack_Clone(p,a,b,c) (p)->lpVtbl->Clone(p,a,b,c)
240 /*****************************************************************************
241 * IDirectMusicTrack8 interface
243 #define INTERFACE IDirectMusicTrack8
244 DECLARE_INTERFACE_(IDirectMusicTrack8,IDirectMusicTrack)
246 /*** IUnknown methods ***/
247 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
248 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
249 STDMETHOD_(ULONG,Release)(THIS) PURE;
250 /*** IDirectMusicTrack methods ***/
251 STDMETHOD(Init)(THIS_ struct IDirectMusicSegment *pSegment) PURE;
252 STDMETHOD(InitPlay)(THIS_ struct IDirectMusicSegmentState *pSegmentState, struct IDirectMusicPerformance *pPerformance, void **ppStateData, DWORD dwVirtualTrackID, DWORD dwFlags) PURE;
253 STDMETHOD(EndPlay)(THIS_ void *pStateData) PURE;
254 STDMETHOD(Play)(THIS_ void *pStateData, MUSIC_TIME mtStart, MUSIC_TIME mtEnd, MUSIC_TIME mtOffset, DWORD dwFlags, struct IDirectMusicPerformance *pPerf, struct IDirectMusicSegmentState *pSegSt, DWORD dwVirtualID) PURE;
255 STDMETHOD(GetParam)(THIS_ REFGUID rguidType, MUSIC_TIME mtTime, MUSIC_TIME *pmtNext, void *pParam) PURE;
256 STDMETHOD(SetParam)(THIS_ REFGUID rguidType, MUSIC_TIME mtTime, void *pParam) PURE;
257 STDMETHOD(IsParamSupported)(THIS_ REFGUID rguidType) PURE;
258 STDMETHOD(AddNotificationType)(THIS_ REFGUID rguidNotificationType) PURE;
259 STDMETHOD(RemoveNotificationType)(THIS_ REFGUID rguidNotificationType) PURE;
260 STDMETHOD(Clone)(THIS_ MUSIC_TIME mtStart, MUSIC_TIME mtEnd, IDirectMusicTrack **ppTrack) PURE;
261 /*** IDirectMusicTrack8 methods ***/
262 STDMETHOD(PlayEx)(THIS_ void *pStateData, REFERENCE_TIME rtStart, REFERENCE_TIME rtEnd, REFERENCE_TIME rtOffset, DWORD dwFlags, struct IDirectMusicPerformance *pPerf, struct IDirectMusicSegmentState *pSegSt, DWORD dwVirtualID) PURE;
263 STDMETHOD(GetParamEx)(THIS_ REFGUID rguidType, REFERENCE_TIME rtTime, REFERENCE_TIME *prtNext, void *pParam, void *pStateData, DWORD dwFlags) PURE;
264 STDMETHOD(SetParamEx)(THIS_ REFGUID rguidType, REFERENCE_TIME rtTime, void *pParam, void *pStateData, DWORD dwFlags) PURE;
265 STDMETHOD(Compose)(THIS_ IUnknown *pContext, DWORD dwTrackGroup, IDirectMusicTrack **ppResultTrack) PURE;
266 STDMETHOD(Join)(THIS_ IDirectMusicTrack *pNewTrack, MUSIC_TIME mtJoin, IUnknown *pContext, DWORD dwTrackGroup, IDirectMusicTrack **ppResultTrack) PURE;
270 #if !defined(__cplusplus) || defined(CINTERFACE)
271 /*** IUnknown methods ***/
272 #define IDirectMusicTrack8_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
273 #define IDirectMusicTrack8_AddRef(p) (p)->lpVtbl->AddRef(p)
274 #define IDirectMusicTrack8_Release(p) (p)->lpVtbl->Release(p)
275 /*** IDirectMusicTrack methods ***/
276 #define IDirectMusicTrack8_Init(p,a) (p)->lpVtbl->Init(p,a)
277 #define IDirectMusicTrack8_InitPlay(p,a,b,c,d,e) (p)->lpVtbl->InitPlay(p,a,b,c,d,e)
278 #define IDirectMusicTrack8_EndPlay(p,a) (p)->lpVtbl->EndPlay(p,a)
279 #define IDirectMusicTrack8_Play(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->Play(p,a,b,c,d,e,f,g,h)
280 #define IDirectMusicTrack8_GetParam(p,a,b,c,d) (p)->lpVtbl->GetParam(p,a,b,c,d)
281 #define IDirectMusicTrack8_SetParam(p,a,b,c) (p)->lpVtbl->SetParam(p,a,b,c)
282 #define IDirectMusicTrack8_IsParamSupported(p,a) (p)->lpVtbl->IsParamSupported(p,a)
283 #define IDirectMusicTrack8_AddNotificationType(p,a) (p)->lpVtbl->AddNotificationType(p,a)
284 #define IDirectMusicTrack8_RemoveNotificationType(p,a) (p)->lpVtbl->RemoveNotificationType(p,a)
285 #define IDirectMusicTrack8_Clone(p,a,b,c) (p)->lpVtbl->Clone(p,a,b,c)
286 /*** IDirectMusicTrack8 methods ***/
287 #define IDirectMusicTrack8_PlayEx(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->PlayEx(p,a,b,c,d,e,f,g,h)
288 #define IDirectMusicTrack8_GetParamEx(p,a,b,c,d,e,f) (p)->lpVtbl->GetParamEx(p,a,b,c,d,e,f)
289 #define IDirectMusicTrack8_SetParamEx(p,a,b,c,d,e) (p)->lpVtbl->SetParamEx(p,a,b,c,d,e)
290 #define IDirectMusicTrack8_Compose(p,a,b,c) (p)->lpVtbl->Compose(p,a,b,c)
291 #define IDirectMusicTrack8_Join(p,a,b,c,d,e) (p)->lpVtbl->Join(p,a,b,c,d,e)
300 #endif /* __WINE_DMUSIC_PLUGIN_H */