1 /* -*- tab-width: 8; c-basic-offset: 4 -*- */
3 /*****************************************************************************
4 * Copyright 1998, Luiz Otavio L. Zorzella
8 * Purpose: multimedia declarations (external to WINMM & MMSYSTEM DLLs
9 * for other DLLs (MCI, drivers...))
11 *****************************************************************************
18 #include "wine/mmsystem16.h"
20 #define MAX_MIDIINDRV (16)
21 /* For now I'm making 16 the maximum number of midi devices one can
22 * have. This should be more than enough for everybody. But as a purist,
23 * I intend to make it unbounded in the future, as soon as I figure
24 * a good way to do so.
26 #define MAX_MIDIOUTDRV (16)
28 /* ==================================
29 * Multimedia DDK compatible part
30 * ================================== */
36 #define DRVM_DISABLE 102
37 #define DRVM_ENABLE 103
39 /* messages that have IOCTL format
40 * dw1 = NULL or handle
41 * dw2 = NULL or ptr to DRVM_IOCTL_DATA
44 #define DRVM_IOCTL 0x100
45 #define DRVM_ADD_THRU (DRVM_IOCTL+1)
46 #define DRVM_REMOVE_THRU (DRVM_IOCTL+2)
47 #define DRVM_IOCTL_LAST (DRVM_IOCTL+5)
49 DWORD dwSize; /* size of this structure */
50 DWORD dwCmd; /* IOCTL command code, 0x80000000 and above reserved for system */
51 } DRVM_IOCTL_DATA, *LPDRVM_IOCTL_DATA;
53 /* command code ranges for dwCmd field of DRVM_IOCTL message
54 * - codes from 0 to 0x7FFFFFFF are user defined
55 * - codes from 0x80000000 to 0xFFFFFFFF are reserved for future definition by microsoft
57 #define DRVM_IOCTL_CMD_USER 0x00000000L
58 #define DRVM_IOCTL_CMD_SYSTEM 0x80000000L
60 #define DRVM_MAPPER 0x2000
61 #define DRVM_USER 0x4000
62 #define DRVM_MAPPER_STATUS (DRVM_MAPPER+0)
63 #define DRVM_MAPPER_RECONFIGURE (DRVM_MAPPER+1)
65 #define DRV_QUERYDRVENTRY (DRV_RESERVED + 1)
66 #define DRV_QUERYDEVNODE (DRV_RESERVED + 2)
67 #define DRV_QUERYNAME (DRV_RESERVED + 3)
68 #define DRV_QUERYDRIVERIDS (DRV_RESERVED + 4)
69 #define DRV_QUERYMAPPABLE (DRV_RESERVED + 5)
71 #define DRV_QUERYDSOUNDIFACE (DRV_RESERVED + 10)
74 #define WODM_INIT DRVM_INIT
75 #define WODM_GETNUMDEVS 3
76 #define WODM_GETDEVCAPS 4
79 #define WODM_PREPARE 7
80 #define WODM_UNPREPARE 8
83 #define WODM_RESTART 11
85 #define WODM_GETPOS 13
86 #define WODM_GETPITCH 14
87 #define WODM_SETPITCH 15
88 #define WODM_GETVOLUME 16
89 #define WODM_SETVOLUME 17
90 #define WODM_GETPLAYBACKRATE 18
91 #define WODM_SETPLAYBACKRATE 19
92 #define WODM_BREAKLOOP 20
94 #define WODM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
95 #define WAVEOUT_MAPPER_STATUS_DEVICE 0
96 #define WAVEOUT_MAPPER_STATUS_MAPPED 1
97 #define WAVEOUT_MAPPER_STATUS_FORMAT 2
99 #define WIDM_INIT DRVM_INIT
100 #define WIDM_GETNUMDEVS 50
101 #define WIDM_GETDEVCAPS 51
103 #define WIDM_CLOSE 53
104 #define WIDM_PREPARE 54
105 #define WIDM_UNPREPARE 55
106 #define WIDM_ADDBUFFER 56
107 #define WIDM_START 57
109 #define WIDM_RESET 59
110 #define WIDM_GETPOS 60
112 #define WIDM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
113 #define WAVEIN_MAPPER_STATUS_DEVICE 0
114 #define WAVEIN_MAPPER_STATUS_MAPPED 1
115 #define WAVEIN_MAPPER_STATUS_FORMAT 2
117 #define MODM_INIT DRVM_INIT
118 #define MODM_GETNUMDEVS 1
119 #define MODM_GETDEVCAPS 2
122 #define MODM_PREPARE 5
123 #define MODM_UNPREPARE 6
125 #define MODM_LONGDATA 8
127 #define MODM_GETVOLUME 10
128 #define MODM_SETVOLUME 11
129 #define MODM_CACHEPATCHES 12
130 #define MODM_CACHEDRUMPATCHES 13
132 #define MIDM_INIT DRVM_INIT
133 #define MIDM_GETNUMDEVS 53
134 #define MIDM_GETDEVCAPS 54
136 #define MIDM_CLOSE 56
137 #define MIDM_PREPARE 57
138 #define MIDM_UNPREPARE 58
139 #define MIDM_ADDBUFFER 59
140 #define MIDM_START 60
142 #define MIDM_RESET 62
145 #define AUXM_INIT DRVM_INIT
146 #define AUXDM_GETNUMDEVS 3
147 #define AUXDM_GETDEVCAPS 4
148 #define AUXDM_GETVOLUME 5
149 #define AUXDM_SETVOLUME 6
151 #define MXDM_INIT DRVM_INIT
152 #define MXDM_USER DRVM_USER
153 #define MXDM_MAPPER DRVM_MAPPER
155 #define MXDM_GETNUMDEVS 1
156 #define MXDM_GETDEVCAPS 2
159 #define MXDM_GETLINEINFO 5
160 #define MXDM_GETLINECONTROLS 6
161 #define MXDM_GETCONTROLDETAILS 7
162 #define MXDM_SETCONTROLDETAILS 8
164 /* pre-defined joystick types */
165 #define JOY_HW_NONE 0
166 #define JOY_HW_CUSTOM 1
167 #define JOY_HW_2A_2B_GENERIC 2
168 #define JOY_HW_2A_4B_GENERIC 3
169 #define JOY_HW_2B_GAMEPAD 4
170 #define JOY_HW_2B_FLIGHTYOKE 5
171 #define JOY_HW_2B_FLIGHTYOKETHROTTLE 6
172 #define JOY_HW_3A_2B_GENERIC 7
173 #define JOY_HW_3A_4B_GENERIC 8
174 #define JOY_HW_4B_GAMEPAD 9
175 #define JOY_HW_4B_FLIGHTYOKE 10
176 #define JOY_HW_4B_FLIGHTYOKETHROTTLE 11
177 #define JOY_HW_LASTENTRY 12
179 /* calibration flags */
180 #define JOY_ISCAL_XY 0x00000001l /* XY are calibrated */
181 #define JOY_ISCAL_Z 0x00000002l /* Z is calibrated */
182 #define JOY_ISCAL_R 0x00000004l /* R is calibrated */
183 #define JOY_ISCAL_U 0x00000008l /* U is calibrated */
184 #define JOY_ISCAL_V 0x00000010l /* V is calibrated */
185 #define JOY_ISCAL_POV 0x00000020l /* POV is calibrated */
187 /* point of view constants */
188 #define JOY_POV_NUMDIRS 4
189 #define JOY_POVVAL_FORWARD 0
190 #define JOY_POVVAL_BACKWARD 1
191 #define JOY_POVVAL_LEFT 2
192 #define JOY_POVVAL_RIGHT 3
194 /* Specific settings for joystick hardware */
195 #define JOY_HWS_HASZ 0x00000001l /* has Z info? */
196 #define JOY_HWS_HASPOV 0x00000002l /* point of view hat present */
197 #define JOY_HWS_POVISBUTTONCOMBOS 0x00000004l /* pov done through combo of buttons */
198 #define JOY_HWS_POVISPOLL 0x00000008l /* pov done through polling */
199 #define JOY_HWS_ISYOKE 0x00000010l /* joystick is a flight yoke */
200 #define JOY_HWS_ISGAMEPAD 0x00000020l /* joystick is a game pad */
201 #define JOY_HWS_ISCARCTRL 0x00000040l /* joystick is a car controller */
202 /* X defaults to J1 X axis */
203 #define JOY_HWS_XISJ1Y 0x00000080l /* X is on J1 Y axis */
204 #define JOY_HWS_XISJ2X 0x00000100l /* X is on J2 X axis */
205 #define JOY_HWS_XISJ2Y 0x00000200l /* X is on J2 Y axis */
206 /* Y defaults to J1 Y axis */
207 #define JOY_HWS_YISJ1X 0x00000400l /* Y is on J1 X axis */
208 #define JOY_HWS_YISJ2X 0x00000800l /* Y is on J2 X axis */
209 #define JOY_HWS_YISJ2Y 0x00001000l /* Y is on J2 Y axis */
210 /* Z defaults to J2 Y axis */
211 #define JOY_HWS_ZISJ1X 0x00002000l /* Z is on J1 X axis */
212 #define JOY_HWS_ZISJ1Y 0x00004000l /* Z is on J1 Y axis */
213 #define JOY_HWS_ZISJ2X 0x00008000l /* Z is on J2 X axis */
214 /* POV defaults to J2 Y axis, if it is not button based */
215 #define JOY_HWS_POVISJ1X 0x00010000l /* pov done through J1 X axis */
216 #define JOY_HWS_POVISJ1Y 0x00020000l /* pov done through J1 Y axis */
217 #define JOY_HWS_POVISJ2X 0x00040000l /* pov done through J2 X axis */
218 /* R defaults to J2 X axis */
219 #define JOY_HWS_HASR 0x00080000l /* has R (4th axis) info */
220 #define JOY_HWS_RISJ1X 0x00100000l /* R done through J1 X axis */
221 #define JOY_HWS_RISJ1Y 0x00200000l /* R done through J1 Y axis */
222 #define JOY_HWS_RISJ2Y 0x00400000l /* R done through J2 X axis */
223 /* U & V for future hardware */
224 #define JOY_HWS_HASU 0x00800000l /* has U (5th axis) info */
225 #define JOY_HWS_HASV 0x01000000l /* has V (6th axis) info */
228 #define JOY_US_HASRUDDER 0x00000001l /* joystick configured with rudder */
229 #define JOY_US_PRESENT 0x00000002l /* is joystick actually present? */
230 #define JOY_US_ISOEM 0x00000004l /* joystick is an OEM defined type */
233 /* struct for storing x,y, z, and rudder values */
234 typedef struct joypos_tag {
243 /* struct for storing ranges */
244 typedef struct joyrange_tag {
248 } JOYRANGE,*LPJOYRANGE;
250 typedef struct joyreguservalues_tag {
251 DWORD dwTimeOut; /* value at which to timeout joystick polling */
252 JOYRANGE jrvRanges; /* range of values app wants returned for axes */
253 JOYPOS jpDeadZone; /* area around center to be considered
254 as "dead". specified as a percentage
255 (0-100). Only X & Y handled by system driver */
256 } JOYREGUSERVALUES, *LPJOYREGUSERVALUES;
258 typedef struct joyreghwsettings_tag {
260 DWORD dwNumButtons; /* number of buttons */
261 } JOYREGHWSETTINGS, *LPJOYHWSETTINGS;
263 /* range of values returned by the hardware (filled in by calibration) */
264 typedef struct joyreghwvalues_tag {
265 JOYRANGE jrvHardware; /* values returned by hardware */
266 DWORD dwPOVValues[JOY_POV_NUMDIRS];/* POV values returned by hardware */
267 DWORD dwCalFlags; /* what has been calibrated */
268 } JOYREGHWVALUES, *LPJOYREGHWVALUES;
270 /* hardware configuration */
271 typedef struct joyreghwconfig_tag {
272 JOYREGHWSETTINGS hws; /* hardware settings */
273 DWORD dwUsageSettings;/* usage settings */
274 JOYREGHWVALUES hwv; /* values returned by hardware */
275 DWORD dwType; /* type of joystick */
276 DWORD dwReserved; /* reserved for OEM drivers */
277 } JOYREGHWCONFIG, *LPJOYREGHWCONFIG;
279 /* joystick calibration info structure */
280 typedef struct joycalibrate_tag {
288 typedef JOYCALIBRATE *LPJOYCALIBRATE;
290 /* prototype for joystick message function */
291 typedef UINT CALLBACK (JOYDEVMSGPROC)(DWORD dwID, UINT uMessage, LPARAM lParam1, LPARAM lParam2);
292 typedef JOYDEVMSGPROC *LPJOYDEVMSGPROC;
294 /* messages sent to joystick driver's DriverProc() function */
295 #define JDD_GETNUMDEVS (DRV_RESERVED + 0x0001)
296 #define JDD_GETDEVCAPS (DRV_RESERVED + 0x0002)
297 #define JDD_GETPOS (DRV_RESERVED + 0x0101)
298 #define JDD_SETCALIBRATION (DRV_RESERVED + 0x0102)
299 #define JDD_CONFIGCHANGED (DRV_RESERVED + 0x0103)
300 #define JDD_GETPOSEX (DRV_RESERVED + 0x0104)
302 #define MCI_MAX_DEVICE_TYPE_LENGTH 80
304 #define MCI_FALSE (MCI_STRING_OFFSET + 19)
305 #define MCI_TRUE (MCI_STRING_OFFSET + 20)
307 #define MCI_FORMAT_RETURN_BASE MCI_FORMAT_MILLISECONDS_S
308 #define MCI_FORMAT_MILLISECONDS_S (MCI_STRING_OFFSET + 21)
309 #define MCI_FORMAT_HMS_S (MCI_STRING_OFFSET + 22)
310 #define MCI_FORMAT_MSF_S (MCI_STRING_OFFSET + 23)
311 #define MCI_FORMAT_FRAMES_S (MCI_STRING_OFFSET + 24)
312 #define MCI_FORMAT_SMPTE_24_S (MCI_STRING_OFFSET + 25)
313 #define MCI_FORMAT_SMPTE_25_S (MCI_STRING_OFFSET + 26)
314 #define MCI_FORMAT_SMPTE_30_S (MCI_STRING_OFFSET + 27)
315 #define MCI_FORMAT_SMPTE_30DROP_S (MCI_STRING_OFFSET + 28)
316 #define MCI_FORMAT_BYTES_S (MCI_STRING_OFFSET + 29)
317 #define MCI_FORMAT_SAMPLES_S (MCI_STRING_OFFSET + 30)
318 #define MCI_FORMAT_TMSF_S (MCI_STRING_OFFSET + 31)
320 #define MCI_VD_FORMAT_TRACK_S (MCI_VD_OFFSET + 5)
322 #define WAVE_FORMAT_PCM_S (MCI_WAVE_OFFSET + 0)
323 #define WAVE_MAPPER_S (MCI_WAVE_OFFSET + 1)
325 #define MCI_SEQ_MAPPER_S (MCI_SEQ_OFFSET + 5)
326 #define MCI_SEQ_FILE_S (MCI_SEQ_OFFSET + 6)
327 #define MCI_SEQ_MIDI_S (MCI_SEQ_OFFSET + 7)
328 #define MCI_SEQ_SMPTE_S (MCI_SEQ_OFFSET + 8)
329 #define MCI_SEQ_FORMAT_SONGPTR_S (MCI_SEQ_OFFSET + 9)
330 #define MCI_SEQ_NONE_S (MCI_SEQ_OFFSET + 10)
331 #define MIDIMAPPER_S (MCI_SEQ_OFFSET + 11)
333 #define MCI_RESOURCE_RETURNED 0x00010000 /* resource ID */
334 #define MCI_COLONIZED3_RETURN 0x00020000 /* colonized ID, 3 bytes data */
335 #define MCI_COLONIZED4_RETURN 0x00040000 /* colonized ID, 4 bytes data */
336 #define MCI_INTEGER_RETURNED 0x00080000 /* integer conversion needed */
337 #define MCI_RESOURCE_DRIVER 0x00100000 /* driver owns returned resource */
339 #define MCI_NO_COMMAND_TABLE 0xFFFF
341 #define MCI_COMMAND_HEAD 0
343 #define MCI_INTEGER 2
344 #define MCI_END_COMMAND 3
347 #define MCI_END_COMMAND_LIST 6
349 #define MCI_CONSTANT 8
350 #define MCI_END_CONSTANT 9
352 #define MAKEMCIRESOURCE(wRet, wRes) MAKELRESULT((wRet), (wRes))
359 } PORTALLOC16, *LPPORTALLOC16;
366 } PORTALLOC, *LPPORTALLOC;
370 LPWAVEFORMATEX lpFormat;
373 UINT16 uMappedDeviceID;
375 } WAVEOPENDESC16, *LPWAVEOPENDESC16;
379 LPWAVEFORMATEX lpFormat;
382 UINT uMappedDeviceID;
384 } WAVEOPENDESC, *LPWAVEOPENDESC;
398 MIDIOPENSTRMID rgIds;
399 } MIDIOPENDESC16, *LPMIDIOPENDESC16;
407 MIDIOPENSTRMID rgIds;
408 } MIDIOPENDESC, *LPMIDIOPENDESC;
414 LPTIMECALLBACK16 lpFunction;
417 } TIMEREVENT, *LPTIMEREVENT;
420 typedef struct tMIXEROPENDESC16
426 } MIXEROPENDESC16, *LPMIXEROPENDESC16;
428 typedef struct tMIXEROPENDESC
434 } MIXEROPENDESC, *LPMIXEROPENDESC;
437 UINT16 wDeviceID; /* device ID */
438 SEGPTR lpstrParams; /* parameter string for entry in SYSTEM.INI */
439 UINT16 wCustomCommandTable; /* custom command table (0xFFFF if none)
440 * filled in by the driver */
441 UINT16 wType; /* driver type (filled in by the driver) */
442 } MCI_OPEN_DRIVER_PARMS16, *LPMCI_OPEN_DRIVER_PARMS16;
445 UINT wDeviceID; /* device ID */
446 LPSTR lpstrParams; /* parameter string for entry in SYSTEM.INI */
447 UINT wCustomCommandTable; /* custom command table (0xFFFF if none) * filled in by the driver */
448 UINT wType; /* driver type (filled in by the driver) */
449 } MCI_OPEN_DRIVER_PARMSA, *LPMCI_OPEN_DRIVER_PARMSA;
452 UINT wDeviceID; /* device ID */
453 LPWSTR lpstrParams; /* parameter string for entry in SYSTEM.INI */
454 UINT wCustomCommandTable; /* custom command table (0xFFFF if none) * filled in by the driver */
455 UINT wType; /* driver type (filled in by the driver) */
456 } MCI_OPEN_DRIVER_PARMSW, *LPMCI_OPEN_DRIVER_PARMSW;
457 DECL_WINELIB_TYPE_AW(MCI_OPEN_DRIVER_PARMS)
458 DECL_WINELIB_TYPE_AW(LPMCI_OPEN_DRIVER_PARMS)
460 DWORD WINAPI mciGetDriverData16(UINT16 uDeviceID);
461 DWORD WINAPI mciGetDriverData(UINT uDeviceID);
463 BOOL16 WINAPI mciSetDriverData16(UINT16 uDeviceID, DWORD dwData);
464 BOOL WINAPI mciSetDriverData(UINT uDeviceID, DWORD dwData);
466 UINT16 WINAPI mciDriverYield16(UINT16 uDeviceID);
467 UINT WINAPI mciDriverYield(UINT uDeviceID);
469 BOOL16 WINAPI mciDriverNotify16(HWND16 hwndCallback, UINT16 uDeviceID,
471 BOOL WINAPI mciDriverNotify(HWND hwndCallback, UINT uDeviceID,
474 UINT16 WINAPI mciLoadCommandResource16(HINSTANCE16 hInstance,
475 LPCSTR lpResName, UINT16 uType);
476 UINT WINAPI mciLoadCommandResource(HINSTANCE hInstance,
477 LPCWSTR lpResName, UINT uType);
479 BOOL16 WINAPI mciFreeCommandResource16(UINT16 uTable);
480 BOOL WINAPI mciFreeCommandResource(UINT uTable);
482 HINSTANCE16 WINAPI mmTaskCreate16(SEGPTR spProc, HINSTANCE16 *lphMmTask, DWORD dwPmt);
483 void WINAPI mmTaskBlock16(HINSTANCE16 hInst);
484 LRESULT WINAPI mmTaskSignal16(HTASK16 ht);
485 void WINAPI mmTaskYield16(void);
487 LRESULT WINAPI mmThreadCreate16(FARPROC16 fpThreadAddr, LPHANDLE lpHndl,
488 DWORD dwPmt, DWORD dwFlags);
489 void WINAPI mmThreadSignal16(HANDLE16 hndl);
490 void WINAPI mmThreadBlock16(HANDLE16 hndl);
491 HANDLE16 WINAPI mmThreadGetTask16(HANDLE16 hndl);
492 BOOL16 WINAPI mmThreadIsValid16(HANDLE16 hndl);
493 BOOL16 WINAPI mmThreadIsCurrent16(HANDLE16 hndl);
495 #define DCB_NULL 0x0000
496 #define DCB_WINDOW 0x0001 /* dwCallback is a HWND */
497 #define DCB_TASK 0x0002 /* dwCallback is a HTASK */
498 #define DCB_FUNCTION 0x0003 /* dwCallback is a FARPROC */
499 #define DCB_EVENT 0x0005 /* dwCallback is an EVENT Handler */
500 #define DCB_TYPEMASK 0x0007
501 #define DCB_NOSWITCH 0x0008 /* don't switch stacks for callback */
503 BOOL16 WINAPI DriverCallback16(DWORD dwCallBack, UINT16 uFlags, HANDLE16 hDev,
504 WORD wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
505 BOOL WINAPI DriverCallback(DWORD dwCallBack, UINT uFlags, HANDLE hDev,
506 UINT wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
510 #endif /* __MMDDK_H */