2 * Copyright 1998, Luiz Otavio L. Zorzella
5 * Purpose: multimedia declarations (external to WINMM & MMSYSTEM DLLs
6 * for other DLLs (MCI, drivers...))
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
33 /* ==================================
34 * Multimedia DDK compatible part
35 * ================================== */
41 #define DRVM_DISABLE 102
42 #define DRVM_ENABLE 103
44 /* messages that have IOCTL format
45 * dw1 = NULL or handle
46 * dw2 = NULL or ptr to DRVM_IOCTL_DATA
49 #define DRVM_IOCTL 0x100
50 #define DRVM_ADD_THRU (DRVM_IOCTL+1)
51 #define DRVM_REMOVE_THRU (DRVM_IOCTL+2)
52 #define DRVM_IOCTL_LAST (DRVM_IOCTL+5)
54 DWORD dwSize
; /* size of this structure */
55 DWORD dwCmd
; /* IOCTL command code, 0x80000000 and above reserved for system */
56 } DRVM_IOCTL_DATA
, *LPDRVM_IOCTL_DATA
;
58 /* command code ranges for dwCmd field of DRVM_IOCTL message
59 * - codes from 0 to 0x7FFFFFFF are user defined
60 * - codes from 0x80000000 to 0xFFFFFFFF are reserved for future definition by microsoft
62 #define DRVM_IOCTL_CMD_USER __MSABI_LONG(0x00000000)
63 #define DRVM_IOCTL_CMD_SYSTEM __MSABI_LONG(0x80000000)
65 #define DRVM_MAPPER 0x2000
66 #define DRVM_USER 0x4000
67 #define DRVM_MAPPER_STATUS (DRVM_MAPPER+0)
68 #define DRVM_MAPPER_RECONFIGURE (DRVM_MAPPER+1)
69 #define DRVM_MAPPER_PREFERRED_GET (DRVM_MAPPER+21)
70 #define DRVM_MAPPER_CONSOLEVOICECOM_GET (DRVM_MAPPER+23)
72 #define DRV_QUERYDRVENTRY (DRV_RESERVED + 1)
73 #define DRV_QUERYDEVNODE (DRV_RESERVED + 2)
74 #define DRV_QUERYNAME (DRV_RESERVED + 3)
75 #define DRV_QUERYDRIVERIDS (DRV_RESERVED + 4)
76 #define DRV_QUERYMAPPABLE (DRV_RESERVED + 5)
77 #define DRV_QUERYMODULE (DRV_RESERVED + 9)
78 #define DRV_PNPINSTALL (DRV_RESERVED + 11)
79 #define DRV_QUERYDEVICEINTERFACE (DRV_RESERVED + 12)
80 #define DRV_QUERYDEVICEINTERFACESIZE (DRV_RESERVED + 13)
81 #define DRV_QUERYSTRINGID (DRV_RESERVED + 14)
82 #define DRV_QUERYSTRINGIDSIZE (DRV_RESERVED + 15)
83 #define DRV_QUERYIDFROMSTRINGID (DRV_RESERVED + 16)
84 #define DRV_QUERYFUNCTIONINSTANCEID (DRV_RESERVED + 17)
85 #define DRV_QUERYFUNCTIONINSTANCEIDSIZE (DRV_RESERVED + 18)
87 #define DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY 0x00000001
89 #define WODM_INIT DRVM_INIT
90 #define WODM_GETNUMDEVS 3
91 #define WODM_GETDEVCAPS 4
94 #define WODM_PREPARE 7
95 #define WODM_UNPREPARE 8
98 #define WODM_RESTART 11
100 #define WODM_GETPOS 13
101 #define WODM_GETPITCH 14
102 #define WODM_SETPITCH 15
103 #define WODM_GETVOLUME 16
104 #define WODM_SETVOLUME 17
105 #define WODM_GETPLAYBACKRATE 18
106 #define WODM_SETPLAYBACKRATE 19
107 #define WODM_BREAKLOOP 20
108 #define WODM_PREFERRED 21
110 #define WODM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
111 #define WAVEOUT_MAPPER_STATUS_DEVICE 0
112 #define WAVEOUT_MAPPER_STATUS_MAPPED 1
113 #define WAVEOUT_MAPPER_STATUS_FORMAT 2
117 #define WIDM_INIT DRVM_INIT
118 #define WIDM_GETNUMDEVS 50
119 #define WIDM_GETDEVCAPS 51
121 #define WIDM_CLOSE 53
122 #define WIDM_PREPARE 54
123 #define WIDM_UNPREPARE 55
124 #define WIDM_ADDBUFFER 56
125 #define WIDM_START 57
127 #define WIDM_RESET 59
128 #define WIDM_GETPOS 60
129 #define WIDM_PREFERRED 61
130 #define WIDM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
131 #define WAVEIN_MAPPER_STATUS_DEVICE 0
132 #define WAVEIN_MAPPER_STATUS_MAPPED 1
133 #define WAVEIN_MAPPER_STATUS_FORMAT 2
135 #define MODM_INIT DRVM_INIT
136 #define MODM_GETNUMDEVS 1
137 #define MODM_GETDEVCAPS 2
140 #define MODM_PREPARE 5
141 #define MODM_UNPREPARE 6
143 #define MODM_LONGDATA 8
145 #define MODM_GETVOLUME 10
146 #define MODM_SETVOLUME 11
147 #define MODM_CACHEPATCHES 12
148 #define MODM_CACHEDRUMPATCHES 13
150 #define MIDM_INIT DRVM_INIT
151 #define MIDM_GETNUMDEVS 53
152 #define MIDM_GETDEVCAPS 54
154 #define MIDM_CLOSE 56
155 #define MIDM_PREPARE 57
156 #define MIDM_UNPREPARE 58
157 #define MIDM_ADDBUFFER 59
158 #define MIDM_START 60
160 #define MIDM_RESET 62
163 #define AUXM_INIT DRVM_INIT
164 #define AUXDM_GETNUMDEVS 3
165 #define AUXDM_GETDEVCAPS 4
166 #define AUXDM_GETVOLUME 5
167 #define AUXDM_SETVOLUME 6
169 #define MXDM_INIT DRVM_INIT
170 #define MXDM_USER DRVM_USER
171 #define MXDM_MAPPER DRVM_MAPPER
173 #define MXDM_GETNUMDEVS 1
174 #define MXDM_GETDEVCAPS 2
177 #define MXDM_GETLINEINFO 5
178 #define MXDM_GETLINECONTROLS 6
179 #define MXDM_GETCONTROLDETAILS 7
180 #define MXDM_SETCONTROLDETAILS 8
182 /* pre-defined joystick types */
183 #define JOY_HW_NONE 0
184 #define JOY_HW_CUSTOM 1
185 #define JOY_HW_2A_2B_GENERIC 2
186 #define JOY_HW_2A_4B_GENERIC 3
187 #define JOY_HW_2B_GAMEPAD 4
188 #define JOY_HW_2B_FLIGHTYOKE 5
189 #define JOY_HW_2B_FLIGHTYOKETHROTTLE 6
190 #define JOY_HW_3A_2B_GENERIC 7
191 #define JOY_HW_3A_4B_GENERIC 8
192 #define JOY_HW_4B_GAMEPAD 9
193 #define JOY_HW_4B_FLIGHTYOKE 10
194 #define JOY_HW_4B_FLIGHTYOKETHROTTLE 11
195 #define JOY_HW_LASTENTRY 12
197 /* calibration flags */
198 #define JOY_ISCAL_XY __MSABI_LONG(0x00000001) /* XY are calibrated */
199 #define JOY_ISCAL_Z __MSABI_LONG(0x00000002) /* Z is calibrated */
200 #define JOY_ISCAL_R __MSABI_LONG(0x00000004) /* R is calibrated */
201 #define JOY_ISCAL_U __MSABI_LONG(0x00000008) /* U is calibrated */
202 #define JOY_ISCAL_V __MSABI_LONG(0x00000010) /* V is calibrated */
203 #define JOY_ISCAL_POV __MSABI_LONG(0x00000020) /* POV is calibrated */
205 /* point of view constants */
206 #define JOY_POV_NUMDIRS 4
207 #define JOY_POVVAL_FORWARD 0
208 #define JOY_POVVAL_BACKWARD 1
209 #define JOY_POVVAL_LEFT 2
210 #define JOY_POVVAL_RIGHT 3
212 /* Specific settings for joystick hardware */
213 #define JOY_HWS_HASZ __MSABI_LONG(0x00000001) /* has Z info? */
214 #define JOY_HWS_HASPOV __MSABI_LONG(0x00000002) /* point of view hat present */
215 #define JOY_HWS_POVISBUTTONCOMBOS __MSABI_LONG(0x00000004) /* pov done through combo of buttons */
216 #define JOY_HWS_POVISPOLL __MSABI_LONG(0x00000008) /* pov done through polling */
217 #define JOY_HWS_ISYOKE __MSABI_LONG(0x00000010) /* joystick is a flight yoke */
218 #define JOY_HWS_ISGAMEPAD __MSABI_LONG(0x00000020) /* joystick is a game pad */
219 #define JOY_HWS_ISCARCTRL __MSABI_LONG(0x00000040) /* joystick is a car controller */
220 /* X defaults to J1 X axis */
221 #define JOY_HWS_XISJ1Y __MSABI_LONG(0x00000080) /* X is on J1 Y axis */
222 #define JOY_HWS_XISJ2X __MSABI_LONG(0x00000100) /* X is on J2 X axis */
223 #define JOY_HWS_XISJ2Y __MSABI_LONG(0x00000200) /* X is on J2 Y axis */
224 /* Y defaults to J1 Y axis */
225 #define JOY_HWS_YISJ1X __MSABI_LONG(0x00000400) /* Y is on J1 X axis */
226 #define JOY_HWS_YISJ2X __MSABI_LONG(0x00000800) /* Y is on J2 X axis */
227 #define JOY_HWS_YISJ2Y __MSABI_LONG(0x00001000) /* Y is on J2 Y axis */
228 /* Z defaults to J2 Y axis */
229 #define JOY_HWS_ZISJ1X __MSABI_LONG(0x00002000) /* Z is on J1 X axis */
230 #define JOY_HWS_ZISJ1Y __MSABI_LONG(0x00004000) /* Z is on J1 Y axis */
231 #define JOY_HWS_ZISJ2X __MSABI_LONG(0x00008000) /* Z is on J2 X axis */
232 /* POV defaults to J2 Y axis, if it is not button based */
233 #define JOY_HWS_POVISJ1X __MSABI_LONG(0x00010000) /* pov done through J1 X axis */
234 #define JOY_HWS_POVISJ1Y __MSABI_LONG(0x00020000) /* pov done through J1 Y axis */
235 #define JOY_HWS_POVISJ2X __MSABI_LONG(0x00040000) /* pov done through J2 X axis */
236 /* R defaults to J2 X axis */
237 #define JOY_HWS_HASR __MSABI_LONG(0x00080000) /* has R (4th axis) info */
238 #define JOY_HWS_RISJ1X __MSABI_LONG(0x00100000) /* R done through J1 X axis */
239 #define JOY_HWS_RISJ1Y __MSABI_LONG(0x00200000) /* R done through J1 Y axis */
240 #define JOY_HWS_RISJ2Y __MSABI_LONG(0x00400000) /* R done through J2 X axis */
241 /* U & V for future hardware */
242 #define JOY_HWS_HASU __MSABI_LONG(0x00800000) /* has U (5th axis) info */
243 #define JOY_HWS_HASV __MSABI_LONG(0x01000000) /* has V (6th axis) info */
246 #define JOY_US_HASRUDDER __MSABI_LONG(0x00000001) /* joystick configured with rudder */
247 #define JOY_US_PRESENT __MSABI_LONG(0x00000002) /* is joystick actually present? */
248 #define JOY_US_ISOEM __MSABI_LONG(0x00000004) /* joystick is an OEM defined type */
251 /* struct for storing x,y, z, and rudder values */
252 typedef struct joypos_tag
{
261 /* struct for storing ranges */
262 typedef struct joyrange_tag
{
266 } JOYRANGE
,*LPJOYRANGE
;
268 typedef struct joyreguservalues_tag
{
269 DWORD dwTimeOut
; /* value at which to timeout joystick polling */
270 JOYRANGE jrvRanges
; /* range of values app wants returned for axes */
271 JOYPOS jpDeadZone
; /* area around center to be considered
272 as "dead". specified as a percentage
273 (0-100). Only X & Y handled by system driver */
274 } JOYREGUSERVALUES
, *LPJOYREGUSERVALUES
;
276 typedef struct joyreghwsettings_tag
{
278 DWORD dwNumButtons
; /* number of buttons */
279 } JOYREGHWSETTINGS
, *LPJOYHWSETTINGS
;
281 /* range of values returned by the hardware (filled in by calibration) */
282 typedef struct joyreghwvalues_tag
{
283 JOYRANGE jrvHardware
; /* values returned by hardware */
284 DWORD dwPOVValues
[JOY_POV_NUMDIRS
];/* POV values returned by hardware */
285 DWORD dwCalFlags
; /* what has been calibrated */
286 } JOYREGHWVALUES
, *LPJOYREGHWVALUES
;
288 /* hardware configuration */
289 typedef struct joyreghwconfig_tag
{
290 JOYREGHWSETTINGS hws
; /* hardware settings */
291 DWORD dwUsageSettings
;/* usage settings */
292 JOYREGHWVALUES hwv
; /* values returned by hardware */
293 DWORD dwType
; /* type of joystick */
294 DWORD dwReserved
; /* reserved for OEM drivers */
295 } JOYREGHWCONFIG
, *LPJOYREGHWCONFIG
;
297 /* joystick calibration info structure */
298 typedef struct joycalibrate_tag
{
306 typedef JOYCALIBRATE
*LPJOYCALIBRATE
;
308 /* prototype for joystick message function */
309 typedef UINT (CALLBACK
* JOYDEVMSGPROC
)(DWORD dwID
, UINT uMessage
, LPARAM lParam1
, LPARAM lParam2
);
310 typedef JOYDEVMSGPROC
*LPJOYDEVMSGPROC
;
312 /* messages sent to joystick driver's DriverProc() function */
313 #define JDD_GETNUMDEVS (DRV_RESERVED + 0x0001)
314 #define JDD_GETDEVCAPS (DRV_RESERVED + 0x0002)
315 #define JDD_GETPOS (DRV_RESERVED + 0x0101)
316 #define JDD_SETCALIBRATION (DRV_RESERVED + 0x0102)
317 #define JDD_CONFIGCHANGED (DRV_RESERVED + 0x0103)
318 #define JDD_GETPOSEX (DRV_RESERVED + 0x0104)
320 #define MCI_MAX_DEVICE_TYPE_LENGTH 80
322 #define MCI_FALSE (MCI_STRING_OFFSET + 19)
323 #define MCI_TRUE (MCI_STRING_OFFSET + 20)
325 #define MCI_FORMAT_RETURN_BASE MCI_FORMAT_MILLISECONDS_S
326 #define MCI_FORMAT_MILLISECONDS_S (MCI_STRING_OFFSET + 21)
327 #define MCI_FORMAT_HMS_S (MCI_STRING_OFFSET + 22)
328 #define MCI_FORMAT_MSF_S (MCI_STRING_OFFSET + 23)
329 #define MCI_FORMAT_FRAMES_S (MCI_STRING_OFFSET + 24)
330 #define MCI_FORMAT_SMPTE_24_S (MCI_STRING_OFFSET + 25)
331 #define MCI_FORMAT_SMPTE_25_S (MCI_STRING_OFFSET + 26)
332 #define MCI_FORMAT_SMPTE_30_S (MCI_STRING_OFFSET + 27)
333 #define MCI_FORMAT_SMPTE_30DROP_S (MCI_STRING_OFFSET + 28)
334 #define MCI_FORMAT_BYTES_S (MCI_STRING_OFFSET + 29)
335 #define MCI_FORMAT_SAMPLES_S (MCI_STRING_OFFSET + 30)
336 #define MCI_FORMAT_TMSF_S (MCI_STRING_OFFSET + 31)
338 #define MCI_VD_FORMAT_TRACK_S (MCI_VD_OFFSET + 5)
340 #define WAVE_FORMAT_PCM_S (MCI_WAVE_OFFSET + 0)
341 #define WAVE_MAPPER_S (MCI_WAVE_OFFSET + 1)
343 #define MCI_SEQ_MAPPER_S (MCI_SEQ_OFFSET + 5)
344 #define MCI_SEQ_FILE_S (MCI_SEQ_OFFSET + 6)
345 #define MCI_SEQ_MIDI_S (MCI_SEQ_OFFSET + 7)
346 #define MCI_SEQ_SMPTE_S (MCI_SEQ_OFFSET + 8)
347 #define MCI_SEQ_FORMAT_SONGPTR_S (MCI_SEQ_OFFSET + 9)
348 #define MCI_SEQ_NONE_S (MCI_SEQ_OFFSET + 10)
349 #define MIDIMAPPER_S (MCI_SEQ_OFFSET + 11)
351 #define MCI_RESOURCE_RETURNED 0x00010000 /* resource ID */
352 #define MCI_COLONIZED3_RETURN 0x00020000 /* colonized ID, 3 bytes data */
353 #define MCI_COLONIZED4_RETURN 0x00040000 /* colonized ID, 4 bytes data */
354 #define MCI_INTEGER_RETURNED 0x00080000 /* integer conversion needed */
355 #define MCI_RESOURCE_DRIVER 0x00100000 /* driver owns returned resource */
357 #define MCI_NO_COMMAND_TABLE 0xFFFF
359 #define MCI_COMMAND_HEAD 0
361 #define MCI_INTEGER 2
362 #define MCI_END_COMMAND 3
365 #define MCI_END_COMMAND_LIST 6
367 #define MCI_CONSTANT 8
368 #define MCI_END_CONSTANT 9
374 #define MCI_INTEGER64 13
377 #define MAKEMCIRESOURCE(wRet, wRes) MAKELRESULT((wRet), (wRes))
381 LPWAVEFORMATEX lpFormat
;
382 DWORD_PTR dwCallback
;
383 DWORD_PTR dwInstance
;
384 UINT uMappedDeviceID
;
386 } WAVEOPENDESC
, *LPWAVEOPENDESC
;
395 DWORD_PTR dwCallback
;
396 DWORD_PTR dwInstance
;
399 MIDIOPENSTRMID rgIds
;
400 } MIDIOPENDESC
, *LPMIDIOPENDESC
;
402 typedef struct tMIXEROPENDESC
406 DWORD_PTR dwCallback
;
407 DWORD_PTR dwInstance
;
409 } MIXEROPENDESC
, *LPMIXEROPENDESC
;
412 UINT wDeviceID
; /* device ID */
413 LPSTR lpstrParams
; /* parameter string for entry in SYSTEM.INI */
414 UINT wCustomCommandTable
; /* custom command table (0xFFFF if none) * filled in by the driver */
415 UINT wType
; /* driver type (filled in by the driver) */
416 } MCI_OPEN_DRIVER_PARMSA
, *LPMCI_OPEN_DRIVER_PARMSA
;
419 UINT wDeviceID
; /* device ID */
420 LPWSTR lpstrParams
; /* parameter string for entry in SYSTEM.INI */
421 UINT wCustomCommandTable
; /* custom command table (0xFFFF if none) * filled in by the driver */
422 UINT wType
; /* driver type (filled in by the driver) */
423 } MCI_OPEN_DRIVER_PARMSW
, *LPMCI_OPEN_DRIVER_PARMSW
;
424 DECL_WINELIB_TYPE_AW(MCI_OPEN_DRIVER_PARMS
)
425 DECL_WINELIB_TYPE_AW(LPMCI_OPEN_DRIVER_PARMS
)
427 DWORD_PTR WINAPI
mciGetDriverData(UINT uDeviceID
);
428 BOOL WINAPI
mciSetDriverData(UINT uDeviceID
, DWORD_PTR dwData
);
429 UINT WINAPI
mciDriverYield(UINT uDeviceID
);
430 BOOL WINAPI
mciDriverNotify(HWND hwndCallback
, UINT uDeviceID
,
432 UINT WINAPI
mciLoadCommandResource(HINSTANCE hInstance
,
433 LPCWSTR lpResName
, UINT uType
);
434 BOOL WINAPI
mciFreeCommandResource(UINT uTable
);
436 #define DCB_NULL 0x0000
437 #define DCB_WINDOW 0x0001 /* dwCallback is a HWND */
438 #define DCB_TASK 0x0002 /* dwCallback is a HTASK */
439 #define DCB_FUNCTION 0x0003 /* dwCallback is a FARPROC */
440 #define DCB_EVENT 0x0005 /* dwCallback is an EVENT Handler */
441 #define DCB_TYPEMASK 0x0007
442 #define DCB_NOSWITCH 0x0008 /* don't switch stacks for callback */
444 BOOL WINAPI
DriverCallback(DWORD_PTR dwCallBack
, DWORD uFlags
, HDRVR hDev
,
445 DWORD wMsg
, DWORD_PTR dwUser
, DWORD_PTR dwParam1
, DWORD_PTR dwParam2
);
447 typedef VOID (*LPTASKCALLBACK
)(DWORD_PTR dwInst
);
449 #define TASKERR_NOTASKSUPPORT 1
450 #define TASKERR_OUTOFMEMORY 2
451 UINT WINAPI
mmTaskCreate(LPTASKCALLBACK
, HANDLE
*, DWORD_PTR
);
452 VOID WINAPI
mmTaskBlock(DWORD
);
453 BOOL WINAPI
mmTaskSignal(DWORD
);
454 VOID WINAPI
mmTaskYield(VOID
);
455 DWORD WINAPI
mmGetCurrentTask(VOID
);
463 #endif /* __MMDDK_H */