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 *****************************************************************************
26 #include "wine/mmsystem16.h"
29 typedef DWORD (WINAPI
*MessageProc16
)(UINT16 wDevID
, UINT16 wMsg
, DWORD dwUser
, DWORD dwParam1
, DWORD dwParam2
);
30 typedef DWORD (WINAPI
*MessageProc32
)(UINT wDevID
, UINT wMsg
, DWORD dwUser
, DWORD dwParam1
, DWORD dwParam2
);
33 WINMM_MAP_NOMEM
, /* ko, memory problem */
34 WINMM_MAP_MSGERROR
, /* ko, unknown message */
35 WINMM_MAP_OK
, /* ok, no memory allocated. to be sent to the proc. */
36 WINMM_MAP_OKMEM
, /* ok, some memory allocated, need to call UnMapMsg. to be sent to the proc. */
39 /* Who said goofy boy ? */
40 #define WINE_DI_MAGIC 0x900F1B01
42 typedef struct tagWINE_DRIVER
45 /* as usual LPWINE_DRIVER == hDriver32 */
57 struct tagWINE_DRIVER
* lpPrevItem
;
58 struct tagWINE_DRIVER
* lpNextItem
;
59 } WINE_DRIVER
, *LPWINE_DRIVER
;
61 typedef DWORD (CALLBACK
*WINEMM_msgFunc16
)(UINT16
, WORD
, DWORD
, DWORD
, DWORD
);
62 typedef DWORD (CALLBACK
*WINEMM_msgFunc32
)(UINT
, UINT
, DWORD
, DWORD
, DWORD
);
64 /* for each loaded driver and each known type of driver, this structure contains
65 * the information needed to access it
67 typedef struct tagWINE_MM_DRIVER_PART
{
68 int nIDMin
; /* lower bound of global indexes for this type */
69 int nIDMax
; /* hhigher bound of global indexes for this type */
71 WINEMM_msgFunc32 fnMessage32
; /* pointer to fonction */
72 WINEMM_msgFunc16 fnMessage16
;
74 } WINE_MM_DRIVER_PART
;
78 #define MMDRV_MIDIIN 2
79 #define MMDRV_MIDIOUT 3
80 #define MMDRV_WAVEIN 4
81 #define MMDRV_WAVEOUT 5
84 /* each low-level .drv will be associated with an instance of this structure */
85 typedef struct tagWINE_MM_DRIVER
{
87 LPSTR drvname
; /* name of the driver */
88 BOOL bIs32
: 1, /* TRUE if 32 bit driver, FALSE for 16 */
89 bIsMapper
: 1; /* TRUE if mapper */
90 WINE_MM_DRIVER_PART parts
[MMDRV_MAX
];/* Information for all known types */
91 } WINE_MM_DRIVER
, *LPWINE_MM_DRIVER
;
93 typedef WINMM_MapType (*MMDRV_MAPFUNC
)(UINT wMsg
, LPDWORD lpdwUser
, LPDWORD lpParam1
, LPDWORD lpParam2
);
95 typedef struct tagWINE_MLD
{
96 /* EPP struct tagWINE_MLD* lpNext; */ /* not used so far */
99 UINT mmdIndex
; /* index to low-level driver in MMDrvs table */
100 DWORD dwDriverInstance
; /* this value is driver related, as opposed to
101 * opendesc.dwInstance which is client (callback) related */
105 DWORD dwClientInstance
;
106 } WINE_MLD
, *LPWINE_MLD
;
110 } WINE_WAVE
, *LPWINE_WAVE
;
114 MIDIOPENDESC mod
; /* FIXME: should be removed */
115 } WINE_MIDI
, *LPWINE_MIDI
;
119 } WINE_MIXER
, *LPWINE_MIXER
;
121 #define WINE_MMTHREAD_CREATED 0x4153494C /* "BSIL" */
122 #define WINE_MMTHREAD_DELETED 0xDEADDEAD
125 DWORD dwSignature
; /* 00 "BSIL" when ok, 0xDEADDEAD when being deleted */
126 DWORD dwCounter
; /* 04 > 1 when in mmThread functions */
127 HANDLE hThread
; /* 08 hThread */
128 DWORD dwThreadID
; /* 0C */
129 FARPROC16 fpThread
; /* 10 address of thread proc (segptr or lin depending on dwFlags) */
130 DWORD dwThreadPmt
; /* 14 parameter to be passed upon thread creation to fpThread */
131 DWORD dwSignalCount
; /* 18 counter used for signaling */
132 HANDLE hEvent
; /* 1C event */
133 HANDLE hVxD
; /* 20 return from OpenVxDHandle */
134 DWORD dwStatus
; /* 24 0x00, 0x10, 0x20, 0x30 */
135 DWORD dwFlags
; /* 28 dwFlags upon creation */
136 HANDLE16 hTask
; /* 2C handle to created task */
139 typedef struct tagWINE_MCIDRIVER
{
142 LPSTR lpstrElementName
;
143 LPSTR lpstrDeviceType
;
146 DRIVERPROC16 driverProc
;
148 YIELDPROC lpfnYieldProc
;
153 UINT uSpecificCmdTable
;
154 struct tagWINE_MCIDRIVER
*lpNext
;
155 } WINE_MCIDRIVER
, *LPWINE_MCIDRIVER
;
157 #define WINE_TIMER_IS32 0x80
159 typedef struct tagWINE_TIMERENTRY
{
167 struct tagWINE_TIMERENTRY
* lpNext
;
168 } WINE_TIMERENTRY
, *LPWINE_TIMERENTRY
;
170 enum mmioProcType
{MMIO_PROC_16
,MMIO_PROC_32A
,MMIO_PROC_32W
};
174 struct IOProcList
*pNext
; /* Next item in linked list */
175 FOURCC fourCC
; /* four-character code identifying IOProc */
176 LPMMIOPROC pIOProc
; /* pointer to IProc */
177 enum mmioProcType type
; /* 16, 32A or 32W */
178 int count
; /* number of objects linked to it */
181 typedef struct tagWINE_MMIO
{
183 struct tagWINE_MMIO
* lpNext
;
184 struct IOProcList
* ioProc
;
189 } WINE_MMIO
, *LPWINE_MMIO
;
191 typedef struct tagWINE_PLAYSOUND
{
197 struct tagWINE_PLAYSOUND
* lpNext
;
198 } WINE_PLAYSOUND
, *LPWINE_PLAYSOUND
;
200 typedef struct tagWINE_MM_IDATA
{
202 HANDLE hWinMM32Instance
;
203 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);
246 void MMDRV_InstallMap(unsigned int, MMDRV_MAPFUNC
, MMDRV_MAPFUNC
,
247 MMDRV_MAPFUNC
, MMDRV_MAPFUNC
, LPDRVCALLBACK
);
250 WINE_MCIDRIVER
* MCI_GetDriver(UINT16 uDevID
);
251 UINT
MCI_GetDriverFromString(LPCSTR str
);
252 DWORD
MCI_WriteString(LPSTR lpDstStr
, DWORD dstSize
, LPCSTR lpSrcStr
);
253 const char* MCI_MessageToString(UINT16 wMsg
);
254 UINT WINAPI
MCI_DefYieldProc(MCIDEVICEID wDevID
, DWORD data
);
255 LRESULT
MCI_CleanUp(LRESULT dwRet
, UINT wMsg
, DWORD dwParam2
);
256 DWORD
MCI_SendCommand(UINT wDevID
, UINT16 wMsg
, DWORD dwParam1
, DWORD dwParam2
, BOOL bFrom32
);
257 DWORD
MCI_SendCommandFrom32(UINT wDevID
, UINT16 wMsg
, DWORD dwParam1
, DWORD dwParam2
);
258 DWORD
MCI_SendCommandFrom16(UINT wDevID
, UINT16 wMsg
, DWORD dwParam1
, DWORD dwParam2
);
260 BOOL
WINMM_CheckForMMSystem(void);
262 UINT
MIXER_Open(LPHMIXER lphMix
, UINT uDeviceID
, DWORD dwCallback
,
263 DWORD dwInstance
, DWORD fdwOpen
, BOOL bFrom32
);
264 UINT
MIDI_OutOpen(HMIDIOUT
* lphMidiOut
, UINT uDeviceID
, DWORD dwCallback
,
265 DWORD dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
266 UINT
MIDI_InOpen(HMIDIIN
* lphMidiIn
, UINT uDeviceID
, DWORD dwCallback
,
267 DWORD dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
268 MMRESULT
MIDI_StreamOpen(HMIDISTRM
* lphMidiStrm
, LPUINT lpuDeviceID
,
269 DWORD cMidi
, DWORD dwCallback
,
270 DWORD dwInstance
, DWORD fdwOpen
, BOOL bFrom32
);
271 UINT
WAVE_Open(HANDLE
* lphndl
, UINT uDeviceID
, UINT uType
,
272 const LPWAVEFORMATEX lpFormat
, DWORD dwCallback
,
273 DWORD dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
275 HMMIO
MMIO_Open(LPSTR szFileName
, MMIOINFO
* refmminfo
,
276 DWORD dwOpenFlags
, enum mmioProcType type
);
277 LPMMIOPROC
MMIO_InstallIOProc(FOURCC fccIOProc
, LPMMIOPROC pIOProc
,
278 DWORD dwFlags
, enum mmioProcType type
);
279 LRESULT
MMIO_SendMessage(HMMIO hmmio
, UINT uMessage
, LPARAM lParam1
,
280 LPARAM lParam2
, enum mmioProcType type
);
281 LPWINE_MMIO
MMIO_Get(HMMIO h
);
283 WORD
TIME_SetEventInternal(UINT wDelay
, UINT wResol
,
284 FARPROC16 lpFunc
, DWORD dwUser
, UINT wFlags
);
285 void TIME_MMTimeStart(void);
286 void TIME_MMTimeStop(void);
288 /* Global variables */
289 extern LPWINE_MM_IDATA WINMM_IData
;
291 /* pointers to 16 bit functions (if sibling MMSYSTEM.DLL is loaded
294 extern WINE_MMTHREAD
* (*pFnGetMMThread16
)(HANDLE16
);
295 extern LPWINE_DRIVER (*pFnOpenDriver16
)(LPCSTR
,LPCSTR
,LPARAM
);
296 extern LRESULT (*pFnCloseDriver16
)(HDRVR16
,LPARAM
,LPARAM
);
297 extern LRESULT (*pFnSendMessage16
)(HDRVR16
,UINT
,LPARAM
,LPARAM
);
298 extern WINMM_MapType (*pFnMciMapMsg16To32A
)(WORD
,WORD
,DWORD
*);
299 extern WINMM_MapType (*pFnMciUnMapMsg16To32A
)(WORD
,WORD
,DWORD
);
300 extern WINMM_MapType (*pFnMciMapMsg32ATo16
)(WORD
,WORD
,DWORD
,DWORD
*);
301 extern WINMM_MapType (*pFnMciUnMapMsg32ATo16
)(WORD
,WORD
,DWORD
,DWORD
);
302 extern LRESULT (*pFnCallMMDrvFunc16
)(FARPROC16
,WORD
,WORD
,LONG
,LONG
,LONG
);
303 extern unsigned (*pFnLoadMMDrvFunc16
)(LPCSTR
,LPWINE_DRIVER
, LPWINE_MM_DRIVER
);
304 extern LRESULT (*pFnMmioCallback16
)(SEGPTR
,LPMMIOINFO
,UINT
,LPARAM
,LPARAM
);
306 /* mmsystem (16 bit files) only functions */
307 void MMDRV_Init16(void);
308 void MMSYSTEM_MMTIME16to32(LPMMTIME mmt32
, const MMTIME16
* mmt16
);
309 void MMSYSTEM_MMTIME32to16(LPMMTIME16 mmt16
, const MMTIME
* mmt32
);
311 /* HANDLE16 -> HANDLE conversions */
312 #define HDRVR_32(h16) ((HDRVR)(ULONG_PTR)(h16))
313 #define HMIDI_32(h16) ((HMIDI)(ULONG_PTR)(h16))
314 #define HMIDIIN_32(h16) ((HMIDIIN)(ULONG_PTR)(h16))
315 #define HMIDIOUT_32(h16) ((HMIDIOUT)(ULONG_PTR)(h16))
316 #define HMIDISTRM_32(h16) ((HMIDISTRM)(ULONG_PTR)(h16))
317 #define HMIXER_32(h16) ((HMIXER)(ULONG_PTR)(h16))
318 #define HMIXEROBJ_32(h16) ((HMIXEROBJ)(ULONG_PTR)(h16))
319 #define HMMIO_32(h16) ((HMMIO)(ULONG_PTR)(h16))
320 #define HWAVE_32(h16) ((HWAVE)(ULONG_PTR)(h16))
321 #define HWAVEIN_32(h16) ((HWAVEIN)(ULONG_PTR)(h16))
322 #define HWAVEOUT_32(h16) ((HWAVEOUT)(ULONG_PTR)(h16))
324 /* HANDLE -> HANDLE16 conversions */
325 #define HDRVR_16(h32) (LOWORD(h32))
326 #define HMIDI_16(h32) (LOWORD(h32))
327 #define HMIDIIN_16(h32) (LOWORD(h32))
328 #define HMIDIOUT_16(h32) (LOWORD(h32))
329 #define HMIDISTRM_16(h32) (LOWORD(h32))
330 #define HMIXER_16(h32) (LOWORD(h32))
331 #define HMIXEROBJ_16(h32) (LOWORD(h32))
332 #define HMMIO_16(h32) (LOWORD(h32))
333 #define HWAVE_16(h32) (LOWORD(h32))
334 #define HWAVEIN_16(h32) (LOWORD(h32))
335 #define HWAVEOUT_16(h32) (LOWORD(h32))