1 /* -*- tab-width: 8; c-basic-offset: 4 -*- */
3 /*****************************************************************************
4 * Copyright 1998, Luiz Otavio L. Zorzella
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 *****************************************************************************
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
);
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. */
38 /* Who said goofy boy ? */
39 #define WINE_DI_MAGIC 0x900F1B01
41 typedef struct tagWINE_DRIVER
44 /* as usual LPWINE_DRIVER == hDriver32 */
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 */
70 WINEMM_msgFunc32 fnMessage32
; /* pointer to fonction */
71 WINEMM_msgFunc16 fnMessage16
;
73 } WINE_MM_DRIVER_PART
;
77 #define MMDRV_MIDIIN 2
78 #define MMDRV_MIDIOUT 3
79 #define MMDRV_WAVEIN 4
80 #define MMDRV_WAVEOUT 5
83 /* each low-level .drv will be associated with an instance of this structure */
84 typedef struct tagWINE_MM_DRIVER
{
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 */
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 */
104 DWORD dwClientInstance
;
105 } WINE_MLD
, *LPWINE_MLD
;
109 } WINE_WAVE
, *LPWINE_WAVE
;
113 MIDIOPENDESC mod
; /* FIXME: should be removed */
114 } WINE_MIDI
, *LPWINE_MIDI
;
118 } WINE_MIXER
, *LPWINE_MIXER
;
120 #define WINE_MMTHREAD_CREATED 0x4153494C /* "BSIL" */
121 #define WINE_MMTHREAD_DELETED 0xDEADDEAD
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 */
138 typedef struct tagWINE_MCIDRIVER
{
141 LPSTR lpstrElementName
;
142 LPSTR lpstrDeviceType
;
145 DRIVERPROC16 driverProc
;
147 YIELDPROC lpfnYieldProc
;
152 UINT uSpecificCmdTable
;
153 struct tagWINE_MCIDRIVER
*lpNext
;
154 } WINE_MCIDRIVER
, *LPWINE_MCIDRIVER
;
156 #define WINE_TIMER_IS32 0x80
158 typedef struct tagWINE_TIMERENTRY
{
166 struct tagWINE_TIMERENTRY
* lpNext
;
167 } WINE_TIMERENTRY
, *LPWINE_TIMERENTRY
;
169 enum mmioProcType
{MMIO_PROC_16
,MMIO_PROC_32A
,MMIO_PROC_32W
};
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
{
182 struct tagWINE_MMIO
* lpNext
;
183 struct IOProcList
* ioProc
;
188 } WINE_MMIO
, *LPWINE_MMIO
;
190 typedef struct tagWINE_PLAYSOUND
{
196 struct tagWINE_PLAYSOUND
* lpNext
;
197 } WINE_PLAYSOUND
, *LPWINE_PLAYSOUND
;
199 typedef struct tagWINE_MM_IDATA
{
201 HANDLE hWinMM32Instance
;
202 HANDLE hWinMM16Instance
;
208 LPWINE_TIMERENTRY lpTimerList
;
210 LPWINE_TIMERENTRY lpTimers
;
212 LPWINE_MCIDRIVER lpMciDrvs
;
213 /* low level drivers (unused yet) */
214 /* LPWINE_WAVE lpWave; */
215 /* LPWINE_MIDI lpMidi; */
216 /* LPWINE_MIXER lpMixer; */
219 /* playsound and sndPlaySound */
220 WINE_PLAYSOUND
* lpPlaySound
;
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
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))