2 * Copyright 1998, Luiz Otavio L. Zorzella
5 * Purpose: multimedia declarations (internal to WINMM & MMSYSTEM DLLs)
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
28 #define WINE_DEFAULT_WINMM_DRIVER "alsa,oss,coreaudio,esd"
29 #define WINE_DEFAULT_WINMM_MAPPER "msacm32.drv"
30 #define WINE_DEFAULT_WINMM_MIDI "midimap.dll"
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_PTR
, DWORD_PTR
, DWORD_PTR
);
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 function */
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 unsigned 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 struct tagWINE_MLD
{
94 /* EPP struct tagWINE_MLD* lpNext; */ /* not used so far */
97 UINT mmdIndex
; /* index to low-level driver in MMDrvs table */
98 DWORD_PTR dwDriverInstance
; /* this value is driver related, as opposed to
99 * opendesc.dwInstance which is client (callback) related */
102 DWORD_PTR dwCallback
;
103 DWORD_PTR dwClientInstance
;
104 } WINE_MLD
, *LPWINE_MLD
;
108 } WINE_WAVE
, *LPWINE_WAVE
;
112 MIDIOPENDESC mod
; /* FIXME: should be removed */
113 } WINE_MIDI
, *LPWINE_MIDI
;
117 } WINE_MIXER
, *LPWINE_MIXER
;
119 #define WINE_MMTHREAD_CREATED 0x4153494C /* "BSIL" */
120 #define WINE_MMTHREAD_DELETED 0xDEADDEAD
123 DWORD dwSignature
; /* 00 "BSIL" when ok, 0xDEADDEAD when being deleted */
124 DWORD dwCounter
; /* 04 > 1 when in mmThread functions */
125 HANDLE hThread
; /* 08 hThread */
126 DWORD dwThreadID
; /* 0C */
127 DWORD fpThread
; /* 10 address of thread proc (segptr or lin depending on dwFlags) */
128 DWORD dwThreadPmt
; /* 14 parameter to be passed upon thread creation to fpThread */
129 LONG dwSignalCount
; /* 18 counter used for signaling */
130 HANDLE hEvent
; /* 1C event */
131 HANDLE hVxD
; /* 20 return from OpenVxDHandle */
132 DWORD dwStatus
; /* 24 0x00, 0x10, 0x20, 0x30 */
133 DWORD dwFlags
; /* 28 dwFlags upon creation */
134 UINT16 hTask
; /* 2C handle to created task */
137 typedef struct tagWINE_MCIDRIVER
{
140 LPWSTR lpstrElementName
;
141 LPWSTR lpstrDeviceType
;
145 YIELDPROC lpfnYieldProc
;
150 UINT uSpecificCmdTable
;
151 struct tagWINE_MCIDRIVER
*lpNext
;
152 } WINE_MCIDRIVER
, *LPWINE_MCIDRIVER
;
154 #define WINE_TIMER_IS32 0x80
156 enum mmioProcType
{MMIO_PROC_16
,MMIO_PROC_32A
,MMIO_PROC_32W
};
160 struct IOProcList
*pNext
; /* Next item in linked list */
161 FOURCC fourCC
; /* four-character code identifying IOProc */
162 LPMMIOPROC pIOProc
; /* pointer to IProc */
163 enum mmioProcType type
; /* 16, 32A or 32W */
164 int count
; /* number of objects linked to it */
167 typedef struct tagWINE_MMIO
{
169 struct tagWINE_MMIO
* lpNext
;
170 struct IOProcList
* ioProc
;
171 unsigned bTmpIOProc
: 1,
175 } WINE_MMIO
, *LPWINE_MMIO
;
177 /* function prototypes */
179 typedef WINMM_MapType (*MMDRV_MAPFUNC
)(UINT wMsg
, DWORD_PTR
*lpdwUser
, DWORD_PTR
* lpParam1
, DWORD_PTR
* lpParam2
);
180 typedef WINMM_MapType (*MMDRV_UNMAPFUNC
)(UINT wMsg
, DWORD_PTR
*lpdwUser
, DWORD_PTR
* lpParam1
, DWORD_PTR
* lpParam2
, MMRESULT ret
);
182 LPWINE_DRIVER
DRIVER_FindFromHDrvr(HDRVR hDrvr
);
183 BOOL
DRIVER_GetLibName(LPCWSTR keyName
, LPCWSTR sectName
, LPWSTR buf
, int sz
);
184 LPWINE_DRIVER
DRIVER_TryOpenDriver32(LPCWSTR fn
, LPARAM lParam2
);
185 void DRIVER_UnloadAll(void);
187 BOOL
MMDRV_Init(void);
188 void MMDRV_Exit(void);
189 UINT
MMDRV_GetNum(UINT
);
190 LPWINE_MLD
MMDRV_Alloc(UINT size
, UINT type
, LPHANDLE hndl
, DWORD
* dwFlags
,
191 DWORD_PTR
* dwCallback
, DWORD_PTR
* dwInstance
, BOOL bFrom32
);
192 void MMDRV_Free(HANDLE hndl
, LPWINE_MLD mld
);
193 DWORD
MMDRV_Open(LPWINE_MLD mld
, UINT wMsg
, DWORD_PTR dwParam1
, DWORD dwParam2
);
194 DWORD
MMDRV_Close(LPWINE_MLD mld
, UINT wMsg
);
195 LPWINE_MLD
MMDRV_Get(HANDLE hndl
, UINT type
, BOOL bCanBeID
);
196 LPWINE_MLD
MMDRV_GetRelated(HANDLE hndl
, UINT srcType
, BOOL bSrcCanBeID
, UINT dstTyped
);
197 DWORD
MMDRV_Message(LPWINE_MLD mld
, UINT wMsg
, DWORD_PTR dwParam1
, DWORD_PTR dwParam2
, BOOL bFrom32
);
198 UINT
MMDRV_PhysicalFeatures(LPWINE_MLD mld
, UINT uMsg
, DWORD_PTR dwParam1
, DWORD_PTR dwParam2
);
199 BOOL
MMDRV_Is32(unsigned int);
200 void MMDRV_InstallMap(unsigned int, MMDRV_MAPFUNC
, MMDRV_UNMAPFUNC
,
201 MMDRV_MAPFUNC
, MMDRV_UNMAPFUNC
, LPDRVCALLBACK
);
203 WINE_MCIDRIVER
* MCI_GetDriver(UINT16 uDevID
);
204 const char* MCI_MessageToString(UINT wMsg
);
205 LRESULT
MCI_CleanUp(LRESULT dwRet
, UINT wMsg
, DWORD_PTR dwParam2
);
206 DWORD
MCI_SendCommand(UINT wDevID
, UINT16 wMsg
, DWORD_PTR dwParam1
, DWORD_PTR dwParam2
, BOOL bFrom32
);
207 UINT
MCI_SetCommandTable(void *table
, UINT uDevType
);
208 BOOL
MCI_DeleteCommandTable(UINT uTbl
, BOOL
delete);
209 LPWSTR
MCI_strdupAtoW(LPCSTR str
);
210 LPSTR
MCI_strdupWtoA(LPCWSTR str
);
212 BOOL
WINMM_CheckForMMSystem(void);
213 const char* WINMM_ErrorToString(MMRESULT error
);
215 UINT
MIXER_Open(LPHMIXER lphMix
, UINT uDeviceID
, DWORD_PTR dwCallback
,
216 DWORD_PTR dwInstance
, DWORD fdwOpen
, BOOL bFrom32
);
217 UINT
MIDI_OutOpen(HMIDIOUT
* lphMidiOut
, UINT uDeviceID
, DWORD_PTR dwCallback
,
218 DWORD_PTR dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
219 UINT
MIDI_InOpen(HMIDIIN
* lphMidiIn
, UINT uDeviceID
, DWORD_PTR dwCallback
,
220 DWORD_PTR dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
221 MMRESULT
MIDI_StreamOpen(HMIDISTRM
* lphMidiStrm
, LPUINT lpuDeviceID
,
222 DWORD cMidi
, DWORD_PTR dwCallback
,
223 DWORD_PTR dwInstance
, DWORD fdwOpen
, BOOL bFrom32
);
224 UINT
WAVE_Open(HANDLE
* lphndl
, UINT uDeviceID
, UINT uType
,
225 LPCWAVEFORMATEX lpFormat
, DWORD_PTR dwCallback
,
226 DWORD_PTR dwInstance
, DWORD dwFlags
, BOOL bFrom32
);
228 HMMIO
MMIO_Open(LPSTR szFileName
, MMIOINFO
* refmminfo
,
229 DWORD dwOpenFlags
, enum mmioProcType type
);
230 LPMMIOPROC
MMIO_InstallIOProc(FOURCC fccIOProc
, LPMMIOPROC pIOProc
,
231 DWORD dwFlags
, enum mmioProcType type
);
232 LRESULT
MMIO_SendMessage(HMMIO hmmio
, UINT uMessage
, LPARAM lParam1
,
233 LPARAM lParam2
, enum mmioProcType type
);
234 LPWINE_MMIO
MMIO_Get(HMMIO h
);
236 WORD
TIME_SetEventInternal(UINT wDelay
, UINT wResol
, LPTIMECALLBACK lpFunc
,
237 DWORD_PTR dwUser
, UINT wFlags
);
238 void TIME_MMTimeStop(void);
240 /* Global variables */
241 extern CRITICAL_SECTION WINMM_cs
;
242 extern HINSTANCE hWinMM32Instance
;
243 extern HANDLE psLastEvent
;
244 extern HANDLE psStopEvent
;
246 /* pointers to 16 bit functions (if sibling MMSYSTEM.DLL is loaded
249 extern WINE_MMTHREAD
* (*pFnGetMMThread16
)(UINT16
);
250 extern LPWINE_DRIVER (*pFnOpenDriver16
)(LPCWSTR
,LPCWSTR
,LPARAM
);
251 extern LRESULT (*pFnCloseDriver16
)(UINT16
,LPARAM
,LPARAM
);
252 extern LRESULT (*pFnSendMessage16
)(UINT16
,UINT
,LPARAM
,LPARAM
);
253 extern WINMM_MapType (*pFnMciMapMsg16To32W
)(WORD
,WORD
,DWORD
,DWORD_PTR
*);
254 extern WINMM_MapType (*pFnMciUnMapMsg16To32W
)(WORD
,WORD
,DWORD
,DWORD_PTR
);
255 extern WINMM_MapType (*pFnMciMapMsg32WTo16
)(WORD
,WORD
,DWORD
,DWORD_PTR
*);
256 extern WINMM_MapType (*pFnMciUnMapMsg32WTo16
)(WORD
,WORD
,DWORD
,DWORD_PTR
);
257 extern LRESULT (*pFnCallMMDrvFunc16
)(DWORD
/* in fact FARPROC16 */,WORD
,WORD
,LONG
,LONG
,LONG
);
258 extern unsigned (*pFnLoadMMDrvFunc16
)(LPCSTR
,LPWINE_DRIVER
, LPWINE_MM_DRIVER
);
259 extern LRESULT (*pFnMmioCallback16
)(DWORD
,LPMMIOINFO
,UINT
,LPARAM
,LPARAM
);
260 extern void (WINAPI
*pFnReleaseThunkLock
)(DWORD
*);
261 extern void (WINAPI
*pFnRestoreThunkLock
)(DWORD
);
263 /* GetDriverFlags() returned bits is not documented (nor the call itself)
264 * Here are Wine only definitions of the bits
266 #define WINE_GDF_EXIST 0x80000000
267 #define WINE_GDF_16BIT 0x10000000
268 #define WINE_GDF_EXTERNAL_MASK 0xF0000000
269 #define WINE_GDF_SESSION 0x00000001