- revisited mmsystem/winmm loading mechanism
[wine/multimedia.git] / dlls / winmm / winemm.h
blob6a29028db2a6882a12c943e6a56a1f2a4e696368
1 /* -*- tab-width: 8; c-basic-offset: 4 -*- */
3 /*****************************************************************************
4 * Copyright 1998, Luiz Otavio L. Zorzella
5 * 1999, Eric Pouech
7 * Purpose: multimedia declarations (internal to WINMM & MMSYSTEM DLLs)
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 *****************************************************************************
25 #include "mmddk.h"
26 #include "wownt32.h"
28 typedef DWORD (WINAPI *MessageProc16)(UINT16 wDevID, UINT16 wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
29 typedef DWORD (WINAPI *MessageProc32)(UINT wDevID, UINT wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
31 typedef enum {
32 WINMM_MAP_NOMEM, /* ko, memory problem */
33 WINMM_MAP_MSGERROR, /* ko, unknown message */
34 WINMM_MAP_OK, /* ok, no memory allocated. to be sent to the proc. */
35 WINMM_MAP_OKMEM, /* ok, some memory allocated, need to call UnMapMsg. to be sent to the proc. */
36 } WINMM_MapType;
38 /* Who said goofy boy ? */
39 #define WINE_DI_MAGIC 0x900F1B01
41 typedef struct tagWINE_DRIVER
43 DWORD dwMagic;
44 /* as usual LPWINE_DRIVER == hDriver32 */
45 DWORD dwFlags;
46 union {
47 struct {
48 HMODULE hModule;
49 DRIVERPROC lpDrvProc;
50 DWORD dwDriverID;
51 } d32;
52 struct {
53 HDRVR16 hDriver16;
54 } d16;
55 } d;
56 struct tagWINE_DRIVER* lpPrevItem;
57 struct tagWINE_DRIVER* lpNextItem;
58 } WINE_DRIVER, *LPWINE_DRIVER;
60 typedef DWORD (CALLBACK *WINEMM_msgFunc16)(UINT16, WORD, DWORD, DWORD, DWORD);
61 typedef DWORD (CALLBACK *WINEMM_msgFunc32)(UINT , UINT, DWORD, DWORD, DWORD);
63 /* for each loaded driver and each known type of driver, this structure contains
64 * the information needed to access it
66 typedef struct tagWINE_MM_DRIVER_PART {
67 int nIDMin; /* lower bound of global indexes for this type */
68 int nIDMax; /* hhigher bound of global indexes for this type */
69 union {
70 WINEMM_msgFunc32 fnMessage32; /* pointer to fonction */
71 WINEMM_msgFunc16 fnMessage16;
72 } u;
73 } WINE_MM_DRIVER_PART;
75 #define MMDRV_AUX 0
76 #define MMDRV_MIXER 1
77 #define MMDRV_MIDIIN 2
78 #define MMDRV_MIDIOUT 3
79 #define MMDRV_WAVEIN 4
80 #define MMDRV_WAVEOUT 5
81 #define MMDRV_MAX 6
83 /* each low-level .drv will be associated with an instance of this structure */
84 typedef struct tagWINE_MM_DRIVER {
85 HDRVR hDriver;
86 LPSTR drvname; /* name of the driver */
87 BOOL bIs32 : 1, /* TRUE if 32 bit driver, FALSE for 16 */
88 bIsMapper : 1; /* TRUE if mapper */
89 WINE_MM_DRIVER_PART parts[MMDRV_MAX];/* Information for all known types */
90 } WINE_MM_DRIVER, *LPWINE_MM_DRIVER;
92 typedef WINMM_MapType (*MMDRV_MAPFUNC)(UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
94 typedef struct tagWINE_MLD {
95 /* EPP struct tagWINE_MLD* lpNext; */ /* not used so far */
96 UINT uDeviceID;
97 UINT type;
98 UINT mmdIndex; /* index to low-level driver in MMDrvs table */
99 DWORD dwDriverInstance; /* this value is driver related, as opposed to
100 * opendesc.dwInstance which is client (callback) related */
101 WORD bFrom32;
102 WORD dwFlags;
103 DWORD dwCallback;
104 DWORD dwClientInstance;
105 } WINE_MLD, *LPWINE_MLD;
107 typedef struct {
108 WINE_MLD mld;
109 } WINE_WAVE, *LPWINE_WAVE;
111 typedef struct {
112 WINE_MLD mld;
113 MIDIOPENDESC mod; /* FIXME: should be removed */
114 } WINE_MIDI, *LPWINE_MIDI;
116 typedef struct {
117 WINE_MLD mld;
118 } WINE_MIXER, *LPWINE_MIXER;
120 #define WINE_MMTHREAD_CREATED 0x4153494C /* "BSIL" */
121 #define WINE_MMTHREAD_DELETED 0xDEADDEAD
123 typedef struct {
124 DWORD dwSignature; /* 00 "BSIL" when ok, 0xDEADDEAD when being deleted */
125 DWORD dwCounter; /* 04 > 1 when in mmThread functions */
126 HANDLE hThread; /* 08 hThread */
127 DWORD dwThreadID; /* 0C */
128 FARPROC16 fpThread; /* 10 address of thread proc (segptr or lin depending on dwFlags) */
129 DWORD dwThreadPmt; /* 14 parameter to be passed upon thread creation to fpThread */
130 DWORD dwSignalCount; /* 18 counter used for signaling */
131 HANDLE hEvent; /* 1C event */
132 HANDLE hVxD; /* 20 return from OpenVxDHandle */
133 DWORD dwStatus; /* 24 0x00, 0x10, 0x20, 0x30 */
134 DWORD dwFlags; /* 28 dwFlags upon creation */
135 HANDLE16 hTask; /* 2C handle to created task */
136 } WINE_MMTHREAD;
138 typedef struct tagWINE_MCIDRIVER {
139 UINT wDeviceID;
140 UINT wType;
141 LPSTR lpstrElementName;
142 LPSTR lpstrDeviceType;
143 LPSTR lpstrAlias;
144 HDRVR hDriver;
145 DRIVERPROC16 driverProc;
146 DWORD dwPrivate;
147 YIELDPROC lpfnYieldProc;
148 DWORD dwYieldData;
149 BOOL bIs32;
150 DWORD CreatorThread;
151 UINT uTypeCmdTable;
152 UINT uSpecificCmdTable;
153 struct tagWINE_MCIDRIVER*lpNext;
154 } WINE_MCIDRIVER, *LPWINE_MCIDRIVER;
156 #define WINE_TIMER_IS32 0x80
158 typedef struct tagWINE_TIMERENTRY {
159 UINT wDelay;
160 UINT wResol;
161 FARPROC16 lpFunc;
162 DWORD dwUser;
163 UINT16 wFlags;
164 UINT16 wTimerID;
165 UINT uCurTime;
166 struct tagWINE_TIMERENTRY* lpNext;
167 } WINE_TIMERENTRY, *LPWINE_TIMERENTRY;
169 enum mmioProcType {MMIO_PROC_16,MMIO_PROC_32A,MMIO_PROC_32W};
171 struct IOProcList
173 struct IOProcList*pNext; /* Next item in linked list */
174 FOURCC fourCC; /* four-character code identifying IOProc */
175 LPMMIOPROC pIOProc; /* pointer to IProc */
176 enum mmioProcType type; /* 16, 32A or 32W */
177 int count; /* number of objects linked to it */
180 typedef struct tagWINE_MMIO {
181 MMIOINFO info;
182 struct tagWINE_MMIO* lpNext;
183 struct IOProcList* ioProc;
184 BOOL bTmpIOProc : 1,
185 bBufferLoaded : 1;
186 SEGPTR segBuffer16;
187 DWORD dwFileSize;
188 } WINE_MMIO, *LPWINE_MMIO;
190 typedef struct tagWINE_PLAYSOUND {
191 BOOL bLoop : 1,
192 bAlloc : 1;
193 LPCWSTR pszSound;
194 HMODULE hMod;
195 DWORD fdwSound;
196 struct tagWINE_PLAYSOUND* lpNext;
197 } WINE_PLAYSOUND, *LPWINE_PLAYSOUND;
199 typedef struct tagWINE_MM_IDATA {
200 /* winmm part */
201 HANDLE hWinMM32Instance;
202 HANDLE hWinMM16Instance;
203 HANDLE h16Module32;
204 CRITICAL_SECTION cs;
205 /* mm timer part */
206 HANDLE hMMTimer;
207 DWORD mmSysTimeMS;
208 LPWINE_TIMERENTRY lpTimerList;
209 int nSizeLpTimers;
210 LPWINE_TIMERENTRY lpTimers;
211 /* mci part */
212 LPWINE_MCIDRIVER lpMciDrvs;
213 /* low level drivers (unused yet) */
214 /* LPWINE_WAVE lpWave; */
215 /* LPWINE_MIDI lpMidi; */
216 /* LPWINE_MIXER lpMixer; */
217 /* mmio part */
218 LPWINE_MMIO lpMMIO;
219 /* playsound and sndPlaySound */
220 WINE_PLAYSOUND* lpPlaySound;
221 HANDLE psLastEvent;
222 HANDLE psStopEvent;
223 } WINE_MM_IDATA, *LPWINE_MM_IDATA;
225 /* function prototypes */
227 typedef LONG (*MCIPROC16)(DWORD, HDRVR16, WORD, DWORD, DWORD);
228 typedef LONG (*MCIPROC)(DWORD, HDRVR, DWORD, DWORD, DWORD);
230 LPWINE_DRIVER DRIVER_FindFromHDrvr(HDRVR hDrvr);
231 BOOL DRIVER_GetLibName(LPCSTR keyName, LPCSTR sectName, LPSTR buf, int sz);
232 LPWINE_DRIVER DRIVER_TryOpenDriver32(LPCSTR fn, LPARAM lParam2);
234 BOOL MMDRV_Init(void);
235 UINT MMDRV_GetNum(UINT);
236 LPWINE_MLD MMDRV_Alloc(UINT size, UINT type, LPHANDLE hndl, DWORD* dwFlags,
237 DWORD* dwCallback, DWORD* dwInstance, BOOL bFrom32);
238 void MMDRV_Free(HANDLE hndl, LPWINE_MLD mld);
239 DWORD MMDRV_Open(LPWINE_MLD mld, UINT wMsg, DWORD dwParam1, DWORD dwParam2);
240 DWORD MMDRV_Close(LPWINE_MLD mld, UINT wMsg);
241 LPWINE_MLD MMDRV_Get(HANDLE hndl, UINT type, BOOL bCanBeID);
242 LPWINE_MLD MMDRV_GetRelated(HANDLE hndl, UINT srcType, BOOL bSrcCanBeID, UINT dstTyped);
243 DWORD MMDRV_Message(LPWINE_MLD mld, WORD wMsg, DWORD dwParam1, DWORD dwParam2, BOOL bFrom32);
244 UINT MMDRV_PhysicalFeatures(LPWINE_MLD mld, UINT uMsg, DWORD dwParam1, DWORD dwParam2);
245 BOOL MMDRV_Is32(unsigned int);
247 WINE_MCIDRIVER* MCI_GetDriver(UINT16 uDevID);
248 UINT MCI_GetDriverFromString(LPCSTR str);
249 DWORD MCI_WriteString(LPSTR lpDstStr, DWORD dstSize, LPCSTR lpSrcStr);
250 const char* MCI_MessageToString(UINT16 wMsg);
251 UINT WINAPI MCI_DefYieldProc(MCIDEVICEID wDevID, DWORD data);
252 LRESULT MCI_CleanUp(LRESULT dwRet, UINT wMsg, DWORD dwParam2, BOOL bIs32);
253 DWORD MCI_SendCommand(UINT wDevID, UINT16 wMsg, DWORD dwParam1, DWORD dwParam2, BOOL bFrom32);
254 DWORD MCI_SendCommandFrom32(UINT wDevID, UINT16 wMsg, DWORD dwParam1, DWORD dwParam2);
255 DWORD MCI_SendCommandFrom16(UINT wDevID, UINT16 wMsg, DWORD dwParam1, DWORD dwParam2);
257 BOOL WINMM_CheckForMMSystem(void);
259 void MMSYSTEM_MMTIME16to32(LPMMTIME mmt32, const MMTIME16* mmt16);
260 void MMSYSTEM_MMTIME32to16(LPMMTIME16 mmt16, const MMTIME* mmt32);
262 UINT MMSYSTEM_mixerOpen(LPHMIXER lphMix, UINT uDeviceID, DWORD dwCallback,
263 DWORD dwInstance, DWORD fdwOpen, BOOL bFrom32);
264 UINT MMSYSTEM_midiOutOpen(HMIDIOUT* lphMidiOut, UINT uDeviceID, DWORD dwCallback,
265 DWORD dwInstance, DWORD dwFlags, BOOL bFrom32);
266 UINT MMSYSTEM_midiInOpen(HMIDIIN* lphMidiIn, UINT uDeviceID, DWORD dwCallback,
267 DWORD dwInstance, DWORD dwFlags, BOOL bFrom32);
268 MMRESULT MMSYSTEM_MidiStream_Open(HMIDISTRM* lphMidiStrm, LPUINT lpuDeviceID,
269 DWORD cMidi, DWORD dwCallback,
270 DWORD dwInstance, DWORD fdwOpen, BOOL bFrom32);
271 UINT MMSYSTEM_waveOpen(HANDLE* lphndl, UINT uDeviceID, UINT uType,
272 const LPWAVEFORMATEX lpFormat, DWORD dwCallback,
273 DWORD dwInstance, DWORD dwFlags, BOOL bFrom32);
275 WORD timeSetEventInternal(UINT wDelay, UINT wResol,
276 FARPROC16 lpFunc, DWORD dwUser, UINT wFlags);
278 HMMIO MMIO_Open(LPSTR szFileName, MMIOINFO* refmminfo,
279 DWORD dwOpenFlags, enum mmioProcType type);
280 LPMMIOPROC MMIO_InstallIOProc(FOURCC fccIOProc, LPMMIOPROC pIOProc,
281 DWORD dwFlags, enum mmioProcType type);
282 LRESULT MMIO_SendMessage(HMMIO hmmio, UINT uMessage, LPARAM lParam1,
283 LPARAM lParam2, enum mmioProcType type);
284 LPWINE_MMIO MMIO_Get(HMMIO h);
286 BOOL MULTIMEDIA_MciInit(void);
287 BOOL MULTIMEDIA_PlaySound(const void* pszSound, HMODULE hmod, DWORD fdwSound, BOOL bUnicode);
289 void TIME_MMTimeStart(void);
290 void TIME_MMTimeStop(void);
292 /* temporary definitions */
293 WINMM_MapType DRIVER_MapMsg32To16(WORD wMsg, DWORD* lParam1, DWORD* lParam2);
294 WINMM_MapType DRIVER_UnMapMsg32To16(WORD wMsg, DWORD lParam1, DWORD lParam2);
295 WINMM_MapType MCI_MapMsg16To32A (WORD uDevType, WORD wMsg, DWORD* lParam);
296 WINMM_MapType MCI_UnMapMsg16To32A(WORD uDevType, WORD wMsg, DWORD lParam);
297 WINMM_MapType MCI_MapMsg32ATo16 (WORD uDevType, WORD wMsg, DWORD dwFlags, DWORD* lParam);
298 WINMM_MapType MCI_UnMapMsg32ATo16(WORD uDevType, WORD wMsg, DWORD dwFlags, DWORD lParam);
299 void MMDRV_Callback(LPWINE_MLD mld, HDRVR hDev, UINT uMsg, DWORD dwParam1, DWORD dwParam2);
301 WINMM_MapType MMDRV_Aux_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
302 WINMM_MapType MMDRV_Aux_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
303 WINMM_MapType MMDRV_Aux_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
304 WINMM_MapType MMDRV_Aux_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
305 void CALLBACK MMDRV_Aux_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
307 WINMM_MapType MMDRV_Mixer_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
308 WINMM_MapType MMDRV_Mixer_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
309 WINMM_MapType MMDRV_Mixer_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
310 WINMM_MapType MMDRV_Mixer_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
311 void CALLBACK MMDRV_Mixer_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
313 WINMM_MapType MMDRV_MidiIn_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
314 WINMM_MapType MMDRV_MidiIn_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
315 WINMM_MapType MMDRV_MidiIn_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
316 WINMM_MapType MMDRV_MidiIn_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
317 void CALLBACK MMDRV_MidiIn_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
319 WINMM_MapType MMDRV_MidiOut_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
320 WINMM_MapType MMDRV_MidiOut_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
321 WINMM_MapType MMDRV_MidiOut_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
322 WINMM_MapType MMDRV_MidiOut_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
323 void CALLBACK MMDRV_MidiOut_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
325 WINMM_MapType MMDRV_WaveIn_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
326 WINMM_MapType MMDRV_WaveIn_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
327 WINMM_MapType MMDRV_WaveIn_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
328 WINMM_MapType MMDRV_WaveIn_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
329 void CALLBACK MMDRV_WaveIn_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
331 WINMM_MapType MMDRV_WaveOut_Map16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
332 WINMM_MapType MMDRV_WaveOut_UnMap16To32A (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
333 WINMM_MapType MMDRV_WaveOut_Map32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
334 WINMM_MapType MMDRV_WaveOut_UnMap32ATo16 (UINT wMsg, LPDWORD lpdwUser, LPDWORD lpParam1, LPDWORD lpParam2);
335 void CALLBACK MMDRV_WaveOut_Callback(HDRVR hDev, UINT uMsg, DWORD dwInstance, DWORD dwParam1, DWORD dwParam2);
337 BOOL MMDRV_GetDescription16(const char* fname, char* buf, int buflen);
339 /* Global variables */
340 extern LPWINE_MM_IDATA WINMM_IData;
342 /* pointers to 16 bit functions (if sibling MMSYSTEM.DLL is loaded
343 * NULL otherwise
345 extern LRESULT (*pFnMmioCallback16)(SEGPTR,LPMMIOINFO,UINT,LPARAM,LPARAM);
346 extern WINE_MMTHREAD* (*pFnGetMMThread16)(HANDLE16);
348 /* HANDLE16 -> HANDLE conversions */
349 #define HDRVR_32(h16) ((HDRVR)(ULONG_PTR)(h16))
350 #define HMIDI_32(h16) ((HMIDI)(ULONG_PTR)(h16))
351 #define HMIDIIN_32(h16) ((HMIDIIN)(ULONG_PTR)(h16))
352 #define HMIDIOUT_32(h16) ((HMIDIOUT)(ULONG_PTR)(h16))
353 #define HMIDISTRM_32(h16) ((HMIDISTRM)(ULONG_PTR)(h16))
354 #define HMIXER_32(h16) ((HMIXER)(ULONG_PTR)(h16))
355 #define HMIXEROBJ_32(h16) ((HMIXEROBJ)(ULONG_PTR)(h16))
356 #define HMMIO_32(h16) ((HMMIO)(ULONG_PTR)(h16))
357 #define HWAVE_32(h16) ((HWAVE)(ULONG_PTR)(h16))
358 #define HWAVEIN_32(h16) ((HWAVEIN)(ULONG_PTR)(h16))
359 #define HWAVEOUT_32(h16) ((HWAVEOUT)(ULONG_PTR)(h16))
361 /* HANDLE -> HANDLE16 conversions */
362 #define HDRVR_16(h32) (LOWORD(h32))
363 #define HMIDI_16(h32) (LOWORD(h32))
364 #define HMIDIIN_16(h32) (LOWORD(h32))
365 #define HMIDIOUT_16(h32) (LOWORD(h32))
366 #define HMIDISTRM_16(h32) (LOWORD(h32))
367 #define HMIXER_16(h32) (LOWORD(h32))
368 #define HMIXEROBJ_16(h32) (LOWORD(h32))
369 #define HMMIO_16(h32) (LOWORD(h32))
370 #define HWAVE_16(h32) (LOWORD(h32))
371 #define HWAVEIN_16(h32) (LOWORD(h32))
372 #define HWAVEOUT_16(h32) (LOWORD(h32))