server: Allow volume information queries to be asynchronous.
[wine/zf.git] / include / dmplugin.h
blob88584e884d48c6383ce7bf2957948f0e56fdb56d
1 /*
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
24 #include <windows.h>
26 #define COM_NO_WINDOWS_H
27 #include <objbase.h>
28 #include <mmsystem.h>
29 #include <dmusici.h>
30 #include <pshpack8.h>
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
36 /*****************************************************************************
37 * Registry path
39 #define DMUS_REGSTR_PATH_TOOLS "Software\\Microsoft\\DirectMusic\\Tools"
42 /*****************************************************************************
43 * Predeclare the interfaces
45 /* CLSIDs */
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);
67 /* IIDs */
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 /*****************************************************************************
90 * Typedef definitions
92 typedef struct _DMUS_PMSG DMUS_PMSG;
93 typedef LONG MUSIC_TIME;
96 /*****************************************************************************
97 * Flags
99 #define DMUS_TRACK_PARAMF_CLOCK 0x1
101 /*****************************************************************************
102 * Enumerations
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,
117 } DMUS_TRACKF_FLAGS;
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;
137 #undef INTERFACE
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)
151 #endif
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;
174 #undef INTERFACE
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)
190 #endif
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;
215 #undef INTERFACE
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)
233 #endif
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;
264 #undef INTERFACE
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)
288 #endif
290 #ifdef __cplusplus
292 #endif
294 #include <poppack.h>
296 #endif /* __WINE_DMUSIC_PLUGIN_H */