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
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.
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.
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
21 #ifndef __WINE_DMUSIC_PLUGIN_H
22 #define __WINE_DMUSIC_PLUGIN_H
26 #define COM_NO_WINDOWS_H
36 /*****************************************************************************
39 #define DMUS_REGSTR_PATH_TOOLS "Software\\Microsoft\\DirectMusic\\Tools"
42 /*****************************************************************************
43 * Predeclare the interfaces
46 DEFINE_GUID(CLSID_DirectMusicBandTrack
, 0xd2ac2894,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
47 DEFINE_GUID(CLSID_DirectMusicChordTrack
, 0xd2ac288b,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
48 DEFINE_GUID(CLSID_DirectMusicChordMapTrack
, 0xd2ac2896,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
49 DEFINE_GUID(CLSID_DirectMusicCommandTrack
, 0xd2ac288c,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
50 DEFINE_GUID(CLSID_DirectMusicLyricsTrack
, 0x995c1cf5,0x54ff,0x11d3,0x8b,0xda,0x00,0x60,0x08,0x93,0xb1,0xb6);
51 DEFINE_GUID(CLSID_DirectMusicMarkerTrack
, 0x55a8fd00,0x4288,0x11d3,0x9b,0xd1,0x8a,0x0d,0x61,0xc8,0x88,0x35);
52 DEFINE_GUID(CLSID_DirectMusicMotifTrack
, 0xd2ac288e,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
53 DEFINE_GUID(CLSID_DirectMusicMuteTrack
, 0xd2ac2898,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
54 DEFINE_GUID(CLSID_DirectMusicParamControlTrack
, 0x4be0537b,0x5c19,0x11d3,0x8b,0xdc,0x00,0x60,0x08,0x93,0xb1,0xb6);
55 DEFINE_GUID(CLSID_DirectMusicScriptTrack
, 0x4108fa85,0x3586,0x11d3,0x8b,0xd7,0x00,0x60,0x08,0x93,0xb1,0xb6);
56 DEFINE_GUID(CLSID_DirectMusicSegmentTriggerTrack
, 0xbae4d665,0x4ea1,0x11d3,0x8b,0xda,0x00,0x60,0x08,0x93,0xb1,0xb6);
57 DEFINE_GUID(CLSID_DirectMusicSeqTrack
, 0xd2ac2886,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
58 DEFINE_GUID(CLSID_DirectMusicSignPostTrack
, 0xf17e8672,0xc3b4,0x11d1,0x87,0x0b,0x00,0x60,0x08,0x93,0xb1,0xbd);
59 DEFINE_GUID(CLSID_DirectMusicStyleTrack
, 0xd2ac288d,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
60 DEFINE_GUID(CLSID_DirectMusicSysExTrack
, 0xd2ac2887,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
61 DEFINE_GUID(CLSID_DirectMusicTempoTrack
, 0xd2ac2885,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
62 DEFINE_GUID(CLSID_DirectMusicTimeSigTrack
, 0xd2ac2888,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
63 DEFINE_GUID(CLSID_DirectMusicWaveTrack
, 0xeed36461,0x9ea5,0x11d3,0x9b,0xd1,0x00,0x80,0xc7,0x15,0x0a,0x74);
64 /* MS doesn't support this in DX 9.0 and newer... but there's no harm in keeping it around */
65 DEFINE_GUID(CLSID_DirectMusicMelodyFormulationTrack
, 0xb0684266,0xb57f,0x11d2,0x97,0xf9,0x00,0xc0,0x4f,0xa3,0x6e,0x58);
68 DEFINE_GUID(IID_IDirectMusicTool
, 0xd2ac28ba,0xb39b,0x11d1,0x87,0x04,0x00,0x60,0x08,0x93,0xb1,0xbd);
69 DEFINE_GUID(IID_IDirectMusicTool8
, 0x0e674303,0x3b05,0x11d3,0x9b,0xd1,0xf9,0xe7,0xf0,0xa0,0x15,0x36);
70 DEFINE_GUID(IID_IDirectMusicTrack
, 0xf96029a1,0x4282,0x11d2,0x87,0x17,0x00,0x60,0x08,0x93,0xb1,0xbd);
71 DEFINE_GUID(IID_IDirectMusicTrack8
, 0x0e674304,0x3b05,0x11d3,0x9b,0xd1,0xf9,0xe7,0xf0,0xa0,0x15,0x36);
73 /* typedef definitions */
74 typedef struct IDirectMusicTrack
*LPDIRECTMUSICTRACK
;
75 typedef struct IDirectMusicTrack8
*LPDIRECTMUSICTRACK8
;
76 typedef struct IDirectMusicTool
*LPDIRECTMUSICTOOL
;
77 typedef struct IDirectMusicTool8
*LPDIRECTMUSICTOOL8
;
78 /* these are from dmusici.h and are needed here */
79 typedef struct IDirectMusicPerformance
*LPDIRECTMUSICPERFORMANCE
;
80 typedef struct IDirectMusicPerformance8
*LPDIRECTMUSICPERFORMANCE8
;
81 typedef struct IDirectMusicSegment
*LPDIRECTMUSICSEGMENT
;
82 typedef struct IDirectMusicSegment8
*LPDIRECTMUSICSEGMENT8
;
83 typedef struct IDirectMusicSegmentState
*LPDIRECTMUSICSEGMENTSTATE
;
84 typedef struct IDirectMusicSegmentState8
*LPDIRECTMUSICSEGMENTSTATE8
;
85 typedef struct IDirectMusicGraph
*LPDIRECTMUSICGRAPH
;
86 typedef struct IDirectMusicGraph IDirectMusicGraph8
, *LPDIRECTMUSICGRAPH8
;
89 /*****************************************************************************
92 typedef struct _DMUS_PMSG DMUS_PMSG
;
93 typedef LONG MUSIC_TIME
;
96 /*****************************************************************************
99 #define DMUS_TRACK_PARAMF_CLOCK 0x1
101 /*****************************************************************************
104 typedef enum enumDMUS_TRACKF_FLAGS
106 DMUS_TRACKF_SEEK
= 0x001,
107 DMUS_TRACKF_LOOP
= 0x002,
108 DMUS_TRACKF_START
= 0x004,
109 DMUS_TRACKF_FLUSH
= 0x008,
110 DMUS_TRACKF_DIRTY
= 0x010,
111 DMUS_TRACKF_NOTIFY_OFF
= 0x020,
112 DMUS_TRACKF_PLAY_OFF
= 0x040,
113 DMUS_TRACKF_LOOPEND
= 0x080,
114 DMUS_TRACKF_STOP
= 0x100,
115 DMUS_TRACKF_RECOMPOSE
= 0x200,
116 DMUS_TRACKF_CLOCK
= 0x400,
119 /*****************************************************************************
120 * IDirectMusicTool interface
122 #define INTERFACE IDirectMusicTool
123 DECLARE_INTERFACE_(IDirectMusicTool
,IUnknown
)
125 /*** IUnknown methods ***/
126 STDMETHOD_(HRESULT
,QueryInterface
)(THIS_ REFIID riid
, void** ppvObject
) PURE
;
127 STDMETHOD_(ULONG
,AddRef
)(THIS
) PURE
;
128 STDMETHOD_(ULONG
,Release
)(THIS
) PURE
;
129 /*** IDirectMusicTool methods ***/
130 STDMETHOD(Init
)(THIS_
struct IDirectMusicGraph
*pGraph
) PURE
;
131 STDMETHOD(GetMsgDeliveryType
)(THIS_ DWORD
*pdwDeliveryType
) PURE
;
132 STDMETHOD(GetMediaTypeArraySize
)(THIS_ DWORD
*pdwNumElements
) PURE
;
133 STDMETHOD(GetMediaTypes
)(THIS_ DWORD
**padwMediaTypes
, DWORD dwNumElements
) PURE
;
134 STDMETHOD(ProcessPMsg
)(THIS_
struct IDirectMusicPerformance
*pPerf
, DMUS_PMSG
*pPMSG
) PURE
;
135 STDMETHOD(Flush
)(THIS_
struct IDirectMusicPerformance
*pPerf
, DMUS_PMSG
*pPMSG
, REFERENCE_TIME rtTime
) PURE
;
139 #if !defined(__cplusplus) || defined(CINTERFACE)
140 /*** IUnknown methods ***/
141 #define IDirectMusicTool_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
142 #define IDirectMusicTool_AddRef(p) (p)->lpVtbl->AddRef(p)
143 #define IDirectMusicTool_Release(p) (p)->lpVtbl->Release(p)
144 /*** IDirectMusicTool methods ***/
145 #define IDirectMusicTool_Init(p,a) (p)->lpVtbl->Init(p,a)
146 #define IDirectMusicTool_GetMsgDeliveryType(p,a) (p)->lpVtbl->GetMsgDeliveryType(p,a)
147 #define IDirectMusicTool_GetMediaTypeArraySize(p,a) (p)->lpVtbl->GetMediaTypeArraySize(p,a)
148 #define IDirectMusicTool_GetMediaTypes(p,a,b) (p)->lpVtbl->GetMediaTypes(p,a,b)
149 #define IDirectMusicTool_ProcessPMsg(p,a,b) (p)->lpVtbl->ProcessPMsg(p,a,b)
150 #define IDirectMusicTool_Flush(p,a,b,c) (p)->lpVtbl->Flush(p,a,b,c)
154 /*****************************************************************************
155 * IDirectMusicTool8 interface
157 #define INTERFACE IDirectMusicTool8
158 DECLARE_INTERFACE_(IDirectMusicTool8
,IDirectMusicTool
)
160 /*** IUnknown methods ***/
161 STDMETHOD_(HRESULT
,QueryInterface
)(THIS_ REFIID riid
, void** ppvObject
) PURE
;
162 STDMETHOD_(ULONG
,AddRef
)(THIS
) PURE
;
163 STDMETHOD_(ULONG
,Release
)(THIS
) PURE
;
164 /*** IDirectMusicTool methods ***/
165 STDMETHOD(Init
)(THIS_
struct IDirectMusicGraph
*pGraph
) PURE
;
166 STDMETHOD(GetMsgDeliveryType
)(THIS_ DWORD
*pdwDeliveryType
) PURE
;
167 STDMETHOD(GetMediaTypeArraySize
)(THIS_ DWORD
*pdwNumElements
) PURE
;
168 STDMETHOD(GetMediaTypes
)(THIS_ DWORD
**padwMediaTypes
, DWORD dwNumElements
) PURE
;
169 STDMETHOD(ProcessPMsg
)(THIS_
struct IDirectMusicPerformance
*pPerf
, DMUS_PMSG
*pPMSG
) PURE
;
170 STDMETHOD(Flush
)(THIS_
struct IDirectMusicPerformance
*pPerf
, DMUS_PMSG
*pPMSG
, REFERENCE_TIME rtTime
) PURE
;
171 /*** IDirectMusicTool8 methods ***/
172 STDMETHOD(Clone
)(THIS_ IDirectMusicTool
**ppTool
) PURE
;
176 #if !defined(__cplusplus) || defined(CINTERFACE)
177 /*** IUnknown methods ***/
178 #define IDirectMusicTool8_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
179 #define IDirectMusicTool8_AddRef(p) (p)->lpVtbl->AddRef(p)
180 #define IDirectMusicTool8_Release(p) (p)->lpVtbl->Release(p)
181 /*** IDirectMusicTool methods ***/
182 #define IDirectMusicTool8_Init(p,a) (p)->lpVtbl->Init(p,a)
183 #define IDirectMusicTool8_GetMsgDeliveryType(p,a) (p)->lpVtbl->GetMsgDeliveryType(p,a)
184 #define IDirectMusicTool8_GetMediaTypeArraySize(p,a) (p)->lpVtbl->GetMediaTypeArraySize(p,a)
185 #define IDirectMusicTool8_GetMediaTypes(p,a,b) (p)->lpVtbl->GetMediaTypes(p,a,b)
186 #define IDirectMusicTool8_ProcessPMsg(p,a,b) (p)->lpVtbl->ProcessPMsg(p,a,b)
187 #define IDirectMusicTool8_Flush(p,a,b) (p)->lpVtbl->Flush(p,a,b)
188 /*** IDirectMusicTool8 methods ***/
189 #define IDirectMusicTool8_Clone(p,a) (p)->lpVtbl->Clone(p,a)
193 /*****************************************************************************
194 * IDirectMusicTrack interface
196 #define INTERFACE IDirectMusicTrack
197 DECLARE_INTERFACE_(IDirectMusicTrack
,IUnknown
)
199 /*** IUnknown methods ***/
200 STDMETHOD_(HRESULT
,QueryInterface
)(THIS_ REFIID riid
, void** ppvObject
) PURE
;
201 STDMETHOD_(ULONG
,AddRef
)(THIS
) PURE
;
202 STDMETHOD_(ULONG
,Release
)(THIS
) PURE
;
203 /*** IDirectMusicTrack methods ***/
204 STDMETHOD(Init
)(THIS_
struct IDirectMusicSegment
*pSegment
) PURE
;
205 STDMETHOD(InitPlay
)(THIS_
struct IDirectMusicSegmentState
*pSegmentState
, struct IDirectMusicPerformance
*pPerformance
, void **ppStateData
, DWORD dwVirtualTrackID
, DWORD dwFlags
) PURE
;
206 STDMETHOD(EndPlay
)(THIS_
void *pStateData
) PURE
;
207 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
;
208 STDMETHOD(GetParam
)(THIS_ REFGUID rguidType
, MUSIC_TIME mtTime
, MUSIC_TIME
*pmtNext
, void *pParam
) PURE
;
209 STDMETHOD(SetParam
)(THIS_ REFGUID rguidType
, MUSIC_TIME mtTime
, void *pParam
) PURE
;
210 STDMETHOD(IsParamSupported
)(THIS_ REFGUID rguidType
) PURE
;
211 STDMETHOD(AddNotificationType
)(THIS_ REFGUID rguidNotificationType
) PURE
;
212 STDMETHOD(RemoveNotificationType
)(THIS_ REFGUID rguidNotificationType
) PURE
;
213 STDMETHOD(Clone
)(THIS_ MUSIC_TIME mtStart
, MUSIC_TIME mtEnd
, IDirectMusicTrack
**ppTrack
) PURE
;
217 #if !defined(__cplusplus) || defined(CINTERFACE)
218 /*** IUnknown methods ***/
219 #define IDirectMusicTrack_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
220 #define IDirectMusicTrack_AddRef(p) (p)->lpVtbl->AddRef(p)
221 #define IDirectMusicTrack_Release(p) (p)->lpVtbl->Release(p)
222 /*** IDirectMusicTrack methods ***/
223 #define IDirectMusicTrack_Init(p,a) (p)->lpVtbl->Init(p,a)
224 #define IDirectMusicTrack_InitPlay(p,a,b,c,d,e) (p)->lpVtbl->InitPlay(p,a,b,c,d,e)
225 #define IDirectMusicTrack_EndPlay(p,a) (p)->lpVtbl->EndPlay(p,a)
226 #define IDirectMusicTrack_Play(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->Play(p,a,b,c,d,e,f,g,h)
227 #define IDirectMusicTrack_GetParam(p,a,b,c,d) (p)->lpVtbl->GetParam(p,a,b,c,d)
228 #define IDirectMusicTrack_SetParam(p,a,b,c) (p)->lpVtbl->SetParam(p,a,b,c)
229 #define IDirectMusicTrack_IsParamSupported(p,a) (p)->lpVtbl->IsParamSupported(p,a)
230 #define IDirectMusicTrack_AddNotificationType(p,a) (p)->lpVtbl->AddNotificationType(p,a)
231 #define IDirectMusicTrack_RemoveNotificationType(p,a) (p)->lpVtbl->RemoveNotificationType(p,a)
232 #define IDirectMusicTrack_Clone(p,a,b,c) (p)->lpVtbl->Clone(p,a,b,c)
236 /*****************************************************************************
237 * IDirectMusicTrack8 interface
239 #define INTERFACE IDirectMusicTrack8
240 DECLARE_INTERFACE_(IDirectMusicTrack8
,IDirectMusicTrack
)
242 /*** IUnknown methods ***/
243 STDMETHOD_(HRESULT
,QueryInterface
)(THIS_ REFIID riid
, void** ppvObject
) PURE
;
244 STDMETHOD_(ULONG
,AddRef
)(THIS
) PURE
;
245 STDMETHOD_(ULONG
,Release
)(THIS
) PURE
;
246 /*** IDirectMusicTrack methods ***/
247 STDMETHOD(Init
)(THIS_
struct IDirectMusicSegment
*pSegment
) PURE
;
248 STDMETHOD(InitPlay
)(THIS_
struct IDirectMusicSegmentState
*pSegmentState
, struct IDirectMusicPerformance
*pPerformance
, void **ppStateData
, DWORD dwVirtualTrackID
, DWORD dwFlags
) PURE
;
249 STDMETHOD(EndPlay
)(THIS_
void *pStateData
) PURE
;
250 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
;
251 STDMETHOD(GetParam
)(THIS_ REFGUID rguidType
, MUSIC_TIME mtTime
, MUSIC_TIME
*pmtNext
, void *pParam
) PURE
;
252 STDMETHOD(SetParam
)(THIS_ REFGUID rguidType
, MUSIC_TIME mtTime
, void *pParam
) PURE
;
253 STDMETHOD(IsParamSupported
)(THIS_ REFGUID rguidType
) PURE
;
254 STDMETHOD(AddNotificationType
)(THIS_ REFGUID rguidNotificationType
) PURE
;
255 STDMETHOD(RemoveNotificationType
)(THIS_ REFGUID rguidNotificationType
) PURE
;
256 STDMETHOD(Clone
)(THIS_ MUSIC_TIME mtStart
, MUSIC_TIME mtEnd
, IDirectMusicTrack
**ppTrack
) PURE
;
257 /*** IDirectMusicTrack8 methods ***/
258 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
;
259 STDMETHOD(GetParamEx
)(THIS_ REFGUID rguidType
, REFERENCE_TIME rtTime
, REFERENCE_TIME
*prtNext
, void *pParam
, void *pStateData
, DWORD dwFlags
) PURE
;
260 STDMETHOD(SetParamEx
)(THIS_ REFGUID rguidType
, REFERENCE_TIME rtTime
, void *pParam
, void *pStateData
, DWORD dwFlags
) PURE
;
261 STDMETHOD(Compose
)(THIS_ IUnknown
*pContext
, DWORD dwTrackGroup
, IDirectMusicTrack
**ppResultTrack
) PURE
;
262 STDMETHOD(Join
)(THIS_ IDirectMusicTrack
*pNewTrack
, MUSIC_TIME mtJoin
, IUnknown
*pContext
, DWORD dwTrackGroup
, IDirectMusicTrack
**ppResultTrack
) PURE
;
266 #if !defined(__cplusplus) || defined(CINTERFACE)
267 /*** IUnknown methods ***/
268 #define IDirectMusicTrack8_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
269 #define IDirectMusicTrack8_AddRef(p) (p)->lpVtbl->AddRef(p)
270 #define IDirectMusicTrack8_Release(p) (p)->lpVtbl->Release(p)
271 /*** IDirectMusicTrack methods ***/
272 #define IDirectMusicTrack8_Init(p,a) (p)->lpVtbl->Init(p,a)
273 #define IDirectMusicTrack8_InitPlay(p,a,b,c,d,e) (p)->lpVtbl->InitPlay(p,a,b,c,d,e)
274 #define IDirectMusicTrack8_EndPlay(p,a) (p)->lpVtbl->EndPlay(p,a)
275 #define IDirectMusicTrack8_Play(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->Play(p,a,b,c,d,e,f,g,h)
276 #define IDirectMusicTrack8_GetParam(p,a,b,c,d) (p)->lpVtbl->GetParam(p,a,b,c,d)
277 #define IDirectMusicTrack8_SetParam(p,a,b,c) (p)->lpVtbl->SetParam(p,a,b,c)
278 #define IDirectMusicTrack8_IsParamSupported(p,a) (p)->lpVtbl->IsParamSupported(p,a)
279 #define IDirectMusicTrack8_AddNotificationType(p,a) (p)->lpVtbl->AddNotificationType(p,a)
280 #define IDirectMusicTrack8_RemoveNotificationType(p,a) (p)->lpVtbl->RemoveNotificationType(p,a)
281 #define IDirectMusicTrack8_Clone(p,a,b,c) (p)->lpVtbl->Clone(p,a,b,c)
282 /*** IDirectMusicTrack8 methods ***/
283 #define IDirectMusicTrack8_PlayEx(p,a,b,c,d,e,f,g,h) (p)->lpVtbl->PlayEx(p,a,b,c,d,e,f,g,h)
284 #define IDirectMusicTrack8_GetParamEx(p,a,b,c,d,e,f) (p)->lpVtbl->GetParamEx(p,a,b,c,d,e,f)
285 #define IDirectMusicTrack8_SetParamEx(p,a,b,c,d,e) (p)->lpVtbl->SetParamEx(p,a,b,c,d,e)
286 #define IDirectMusicTrack8_Compose(p,a,b,c) (p)->lpVtbl->Compose(p,a,b,c)
287 #define IDirectMusicTrack8_Join(p,a,b,c,d,e) (p)->lpVtbl->Join(p,a,b,c,d,e)
296 #endif /* __WINE_DMUSIC_PLUGIN_H */