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 *****************************************************************************
19 #define MAX_MIDIINDRV (16)
20 /* For now I'm making 16 the maximum number of midi devices one can
21 * have. This should be more than enough for everybody. But as a purist,
22 * I intend to make it unbounded in the future, as soon as I figure
23 * a good way to do so.
25 #define MAX_MIDIOUTDRV (16)
27 /* ==================================
28 * Multimedia DDK compatible part
29 * ================================== */
35 #define DRVM_DISABLE 102
36 #define DRVM_ENABLE 103
38 /* messages that have IOCTL format
39 * dw1 = NULL or handle
40 * dw2 = NULL or ptr to DRVM_IOCTL_DATA
43 #define DRVM_IOCTL 0x100
44 #define DRVM_ADD_THRU (DRVM_IOCTL+1)
45 #define DRVM_REMOVE_THRU (DRVM_IOCTL+2)
46 #define DRVM_IOCTL_LAST (DRVM_IOCTL+5)
48 DWORD dwSize
; /* size of this structure */
49 DWORD dwCmd
; /* IOCTL command code, 0x80000000 and above reserved for system */
50 } DRVM_IOCTL_DATA
, *LPDRVM_IOCTL_DATA
;
52 /* command code ranges for dwCmd field of DRVM_IOCTL message
53 * - codes from 0 to 0x7FFFFFFF are user defined
54 * - codes from 0x80000000 to 0xFFFFFFFF are reserved for future definition by microsoft
56 #define DRVM_IOCTL_CMD_USER 0x00000000L
57 #define DRVM_IOCTL_CMD_SYSTEM 0x80000000L
59 #define DRVM_MAPPER 0x2000
60 #define DRVM_USER 0x4000
61 #define DRVM_MAPPER_STATUS (DRVM_MAPPER+0)
62 #define DRVM_MAPPER_RECONFIGURE (DRVM_MAPPER+1)
64 #define WODM_INIT DRVM_INIT
65 #define WODM_GETNUMDEVS 3
66 #define WODM_GETDEVCAPS 4
69 #define WODM_PREPARE 7
70 #define WODM_UNPREPARE 8
73 #define WODM_RESTART 11
75 #define WODM_GETPOS 13
76 #define WODM_GETPITCH 14
77 #define WODM_SETPITCH 15
78 #define WODM_GETVOLUME 16
79 #define WODM_SETVOLUME 17
80 #define WODM_GETPLAYBACKRATE 18
81 #define WODM_SETPLAYBACKRATE 19
82 #define WODM_BREAKLOOP 20
84 #define WODM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
85 #define WAVEOUT_MAPPER_STATUS_DEVICE 0
86 #define WAVEOUT_MAPPER_STATUS_MAPPED 1
87 #define WAVEOUT_MAPPER_STATUS_FORMAT 2
89 #define WIDM_INIT DRVM_INIT
90 #define WIDM_GETNUMDEVS 50
91 #define WIDM_GETDEVCAPS 51
94 #define WIDM_PREPARE 54
95 #define WIDM_UNPREPARE 55
96 #define WIDM_ADDBUFFER 56
100 #define WIDM_GETPOS 60
102 #define WIDM_MAPPER_STATUS (DRVM_MAPPER_STATUS + 0)
103 #define WAVEIN_MAPPER_STATUS_DEVICE 0
104 #define WAVEIN_MAPPER_STATUS_MAPPED 1
105 #define WAVEIN_MAPPER_STATUS_FORMAT 2
107 #define MODM_INIT DRVM_INIT
108 #define MODM_GETNUMDEVS 1
109 #define MODM_GETDEVCAPS 2
112 #define MODM_PREPARE 5
113 #define MODM_UNPREPARE 6
115 #define MODM_LONGDATA 8
117 #define MODM_GETVOLUME 10
118 #define MODM_SETVOLUME 11
119 #define MODM_CACHEPATCHES 12
120 #define MODM_CACHEDRUMPATCHES 13
122 #define MIDM_INIT DRVM_INIT
123 #define MIDM_GETNUMDEVS 53
124 #define MIDM_GETDEVCAPS 54
126 #define MIDM_CLOSE 56
127 #define MIDM_PREPARE 57
128 #define MIDM_UNPREPARE 58
129 #define MIDM_ADDBUFFER 59
130 #define MIDM_START 60
132 #define MIDM_RESET 62
135 #define AUXM_INIT DRVM_INIT
136 #define AUXDM_GETNUMDEVS 3
137 #define AUXDM_GETDEVCAPS 4
138 #define AUXDM_GETVOLUME 5
139 #define AUXDM_SETVOLUME 6
141 #define MXDM_INIT DRVM_INIT
142 #define MXDM_USER DRVM_USER
143 #define MXDM_MAPPER DRVM_MAPPER
145 #define MXDM_GETNUMDEVS 1
146 #define MXDM_GETDEVCAPS 2
149 #define MXDM_GETLINEINFO 5
150 #define MXDM_GETLINECONTROLS 6
151 #define MXDM_GETCONTROLDETAILS 7
152 #define MXDM_SETCONTROLDETAILS 8
154 /* pre-defined joystick types */
155 #define JOY_HW_NONE 0
156 #define JOY_HW_CUSTOM 1
157 #define JOY_HW_2A_2B_GENERIC 2
158 #define JOY_HW_2A_4B_GENERIC 3
159 #define JOY_HW_2B_GAMEPAD 4
160 #define JOY_HW_2B_FLIGHTYOKE 5
161 #define JOY_HW_2B_FLIGHTYOKETHROTTLE 6
162 #define JOY_HW_3A_2B_GENERIC 7
163 #define JOY_HW_3A_4B_GENERIC 8
164 #define JOY_HW_4B_GAMEPAD 9
165 #define JOY_HW_4B_FLIGHTYOKE 10
166 #define JOY_HW_4B_FLIGHTYOKETHROTTLE 11
167 #define JOY_HW_LASTENTRY 12
169 /* calibration flags */
170 #define JOY_ISCAL_XY 0x00000001l /* XY are calibrated */
171 #define JOY_ISCAL_Z 0x00000002l /* Z is calibrated */
172 #define JOY_ISCAL_R 0x00000004l /* R is calibrated */
173 #define JOY_ISCAL_U 0x00000008l /* U is calibrated */
174 #define JOY_ISCAL_V 0x00000010l /* V is calibrated */
175 #define JOY_ISCAL_POV 0x00000020l /* POV is calibrated */
177 /* point of view constants */
178 #define JOY_POV_NUMDIRS 4
179 #define JOY_POVVAL_FORWARD 0
180 #define JOY_POVVAL_BACKWARD 1
181 #define JOY_POVVAL_LEFT 2
182 #define JOY_POVVAL_RIGHT 3
184 /* Specific settings for joystick hardware */
185 #define JOY_HWS_HASZ 0x00000001l /* has Z info? */
186 #define JOY_HWS_HASPOV 0x00000002l /* point of view hat present */
187 #define JOY_HWS_POVISBUTTONCOMBOS 0x00000004l /* pov done through combo of buttons */
188 #define JOY_HWS_POVISPOLL 0x00000008l /* pov done through polling */
189 #define JOY_HWS_ISYOKE 0x00000010l /* joystick is a flight yoke */
190 #define JOY_HWS_ISGAMEPAD 0x00000020l /* joystick is a game pad */
191 #define JOY_HWS_ISCARCTRL 0x00000040l /* joystick is a car controller */
192 /* X defaults to J1 X axis */
193 #define JOY_HWS_XISJ1Y 0x00000080l /* X is on J1 Y axis */
194 #define JOY_HWS_XISJ2X 0x00000100l /* X is on J2 X axis */
195 #define JOY_HWS_XISJ2Y 0x00000200l /* X is on J2 Y axis */
196 /* Y defaults to J1 Y axis */
197 #define JOY_HWS_YISJ1X 0x00000400l /* Y is on J1 X axis */
198 #define JOY_HWS_YISJ2X 0x00000800l /* Y is on J2 X axis */
199 #define JOY_HWS_YISJ2Y 0x00001000l /* Y is on J2 Y axis */
200 /* Z defaults to J2 Y axis */
201 #define JOY_HWS_ZISJ1X 0x00002000l /* Z is on J1 X axis */
202 #define JOY_HWS_ZISJ1Y 0x00004000l /* Z is on J1 Y axis */
203 #define JOY_HWS_ZISJ2X 0x00008000l /* Z is on J2 X axis */
204 /* POV defaults to J2 Y axis, if it is not button based */
205 #define JOY_HWS_POVISJ1X 0x00010000l /* pov done through J1 X axis */
206 #define JOY_HWS_POVISJ1Y 0x00020000l /* pov done through J1 Y axis */
207 #define JOY_HWS_POVISJ2X 0x00040000l /* pov done through J2 X axis */
208 /* R defaults to J2 X axis */
209 #define JOY_HWS_HASR 0x00080000l /* has R (4th axis) info */
210 #define JOY_HWS_RISJ1X 0x00100000l /* R done through J1 X axis */
211 #define JOY_HWS_RISJ1Y 0x00200000l /* R done through J1 Y axis */
212 #define JOY_HWS_RISJ2Y 0x00400000l /* R done through J2 X axis */
213 /* U & V for future hardware */
214 #define JOY_HWS_HASU 0x00800000l /* has U (5th axis) info */
215 #define JOY_HWS_HASV 0x01000000l /* has V (6th axis) info */
218 #define JOY_US_HASRUDDER 0x00000001l /* joystick configured with rudder */
219 #define JOY_US_PRESENT 0x00000002l /* is joystick actually present? */
220 #define JOY_US_ISOEM 0x00000004l /* joystick is an OEM defined type */
223 /* struct for storing x,y, z, and rudder values */
224 typedef struct joypos_tag
{
233 /* struct for storing ranges */
234 typedef struct joyrange_tag
{
238 } JOYRANGE
,*LPJOYRANGE
;
240 typedef struct joyreguservalues_tag
{
241 DWORD dwTimeOut
; /* value at which to timeout joystick polling */
242 JOYRANGE jrvRanges
; /* range of values app wants returned for axes */
243 JOYPOS jpDeadZone
; /* area around center to be considered
244 as "dead". specified as a percentage
245 (0-100). Only X & Y handled by system driver */
246 } JOYREGUSERVALUES
, *LPJOYREGUSERVALUES
;
248 typedef struct joyreghwsettings_tag
{
250 DWORD dwNumButtons
; /* number of buttons */
251 } JOYREGHWSETTINGS
, *LPJOYHWSETTINGS
;
253 /* range of values returned by the hardware (filled in by calibration) */
254 typedef struct joyreghwvalues_tag
{
255 JOYRANGE jrvHardware
; /* values returned by hardware */
256 DWORD dwPOVValues
[JOY_POV_NUMDIRS
];/* POV values returned by hardware */
257 DWORD dwCalFlags
; /* what has been calibrated */
258 } JOYREGHWVALUES
, *LPJOYREGHWVALUES
;
260 /* hardware configuration */
261 typedef struct joyreghwconfig_tag
{
262 JOYREGHWSETTINGS hws
; /* hardware settings */
263 DWORD dwUsageSettings
;/* usage settings */
264 JOYREGHWVALUES hwv
; /* values returned by hardware */
265 DWORD dwType
; /* type of joystick */
266 DWORD dwReserved
; /* reserved for OEM drivers */
267 } JOYREGHWCONFIG
, *LPJOYREGHWCONFIG
;
269 /* joystick calibration info structure */
270 typedef struct joycalibrate_tag
{
278 typedef JOYCALIBRATE
*LPJOYCALIBRATE
;
280 /* prototype for joystick message function */
281 typedef UINT (CALLBACK JOYDEVMSGPROC
)(DWORD dwID
, UINT uMessage
, LPARAM lParam1
, LPARAM lParam2
);
282 typedef JOYDEVMSGPROC
*LPJOYDEVMSGPROC
;
284 /* messages sent to joystick driver's DriverProc() function */
285 #define JDD_GETNUMDEVS (DRV_RESERVED + 0x0001)
286 #define JDD_GETDEVCAPS (DRV_RESERVED + 0x0002)
287 #define JDD_GETPOS (DRV_RESERVED + 0x0101)
288 #define JDD_SETCALIBRATION (DRV_RESERVED + 0x0102)
289 #define JDD_CONFIGCHANGED (DRV_RESERVED + 0x0103)
290 #define JDD_GETPOSEX (DRV_RESERVED + 0x0104)
292 #define MCI_MAX_DEVICE_TYPE_LENGTH 80
294 #define MCI_FALSE (MCI_STRING_OFFSET + 19)
295 #define MCI_TRUE (MCI_STRING_OFFSET + 20)
297 #define MCI_FORMAT_RETURN_BASE MCI_FORMAT_MILLISECONDS_S
298 #define MCI_FORMAT_MILLISECONDS_S (MCI_STRING_OFFSET + 21)
299 #define MCI_FORMAT_HMS_S (MCI_STRING_OFFSET + 22)
300 #define MCI_FORMAT_MSF_S (MCI_STRING_OFFSET + 23)
301 #define MCI_FORMAT_FRAMES_S (MCI_STRING_OFFSET + 24)
302 #define MCI_FORMAT_SMPTE_24_S (MCI_STRING_OFFSET + 25)
303 #define MCI_FORMAT_SMPTE_25_S (MCI_STRING_OFFSET + 26)
304 #define MCI_FORMAT_SMPTE_30_S (MCI_STRING_OFFSET + 27)
305 #define MCI_FORMAT_SMPTE_30DROP_S (MCI_STRING_OFFSET + 28)
306 #define MCI_FORMAT_BYTES_S (MCI_STRING_OFFSET + 29)
307 #define MCI_FORMAT_SAMPLES_S (MCI_STRING_OFFSET + 30)
308 #define MCI_FORMAT_TMSF_S (MCI_STRING_OFFSET + 31)
310 #define MCI_VD_FORMAT_TRACK_S (MCI_VD_OFFSET + 5)
312 #define WAVE_FORMAT_PCM_S (MCI_WAVE_OFFSET + 0)
313 #define WAVE_MAPPER_S (MCI_WAVE_OFFSET + 1)
315 #define MCI_SEQ_MAPPER_S (MCI_SEQ_OFFSET + 5)
316 #define MCI_SEQ_FILE_S (MCI_SEQ_OFFSET + 6)
317 #define MCI_SEQ_MIDI_S (MCI_SEQ_OFFSET + 7)
318 #define MCI_SEQ_SMPTE_S (MCI_SEQ_OFFSET + 8)
319 #define MCI_SEQ_FORMAT_SONGPTR_S (MCI_SEQ_OFFSET + 9)
320 #define MCI_SEQ_NONE_S (MCI_SEQ_OFFSET + 10)
321 #define MIDIMAPPER_S (MCI_SEQ_OFFSET + 11)
323 #define MCI_RESOURCE_RETURNED 0x00010000 /* resource ID */
324 #define MCI_COLONIZED3_RETURN 0x00020000 /* colonized ID, 3 bytes data */
325 #define MCI_COLONIZED4_RETURN 0x00040000 /* colonized ID, 4 bytes data */
326 #define MCI_INTEGER_RETURNED 0x00080000 /* integer conversion needed */
327 #define MCI_RESOURCE_DRIVER 0x00100000 /* driver owns returned resource */
329 #define MCI_NO_COMMAND_TABLE 0xFFFF
331 #define MCI_COMMAND_HEAD 0
333 #define MCI_INTEGER 2
334 #define MCI_END_COMMAND 3
337 #define MCI_END_COMMAND_LIST 6
339 #define MCI_CONSTANT 8
340 #define MCI_END_CONSTANT 9
342 #define MAKEMCIRESOURCE(wRet, wRes) MAKELRESULT((wRet), (wRes))
349 } PORTALLOC16
, *LPPORTALLOC16
;
356 } PORTALLOC
, *LPPORTALLOC
;
360 LPWAVEFORMATEX lpFormat
;
363 UINT16 uMappedDeviceID
;
365 } WAVEOPENDESC16
, *LPWAVEOPENDESC16
;
369 LPWAVEFORMATEX lpFormat
;
372 UINT uMappedDeviceID
;
374 } WAVEOPENDESC
, *LPWAVEOPENDESC
;
388 MIDIOPENSTRMID rgIds
;
389 } MIDIOPENDESC16
, *LPMIDIOPENDESC16
;
397 MIDIOPENSTRMID rgIds
;
398 } MIDIOPENDESC
, *LPMIDIOPENDESC
;
404 LPTIMECALLBACK16 lpFunction
;
407 } TIMEREVENT
, *LPTIMEREVENT
;
410 typedef struct tMIXEROPENDESC16
416 } MIXEROPENDESC16
, *LPMIXEROPENDESC16
;
418 typedef struct tMIXEROPENDESC
424 } MIXEROPENDESC
, *LPMIXEROPENDESC
;
427 UINT16 wDeviceID
; /* device ID */
428 LPSTR lpstrParams
; /* parameter string for entry in SYSTEM.INI */
429 UINT16 wCustomCommandTable
; /* custom command table (0xFFFF if none)
430 * filled in by the driver */
431 UINT16 wType
; /* driver type (filled in by the driver) */
432 } MCI_OPEN_DRIVER_PARMS16
, *LPMCI_OPEN_DRIVER_PARMS16
;
435 UINT wDeviceID
; /* device ID */
436 LPSTR lpstrParams
; /* parameter string for entry in SYSTEM.INI */
437 UINT wCustomCommandTable
; /* custom command table (0xFFFF if none) * filled in by the driver */
438 UINT wType
; /* driver type (filled in by the driver) */
439 } MCI_OPEN_DRIVER_PARMSA
, *LPMCI_OPEN_DRIVER_PARMSA
;
442 UINT wDeviceID
; /* device ID */
443 LPWSTR lpstrParams
; /* parameter string for entry in SYSTEM.INI */
444 UINT wCustomCommandTable
; /* custom command table (0xFFFF if none) * filled in by the driver */
445 UINT wType
; /* driver type (filled in by the driver) */
446 } MCI_OPEN_DRIVER_PARMSW
, *LPMCI_OPEN_DRIVER_PARMSW
;
447 DECL_WINELIB_TYPE_AW(MCI_OPEN_DRIVER_PARMS
)
448 DECL_WINELIB_TYPE_AW(LPMCI_OPEN_DRIVER_PARMS
)
450 DWORD WINAPI
mciGetDriverData16(UINT16 uDeviceID
);
451 DWORD WINAPI
mciGetDriverData(UINT uDeviceID
);
453 BOOL16 WINAPI
mciSetDriverData16(UINT16 uDeviceID
, DWORD dwData
);
454 BOOL WINAPI
mciSetDriverData(UINT uDeviceID
, DWORD dwData
);
456 UINT16 WINAPI
mciDriverYield16(UINT16 uDeviceID
);
457 UINT WINAPI
mciDriverYield(UINT uDeviceID
);
459 BOOL16 WINAPI
mciDriverNotify16(HWND16 hwndCallback
, UINT16 uDeviceID
,
461 BOOL WINAPI
mciDriverNotify(HWND hwndCallback
, UINT uDeviceID
,
464 UINT16 WINAPI
mciLoadCommandResource16(HINSTANCE16 hInstance
,
465 LPCSTR lpResName
, UINT16 uType
);
466 UINT WINAPI
mciLoadCommandResource(HINSTANCE hInstance
,
467 LPCWSTR lpResName
, UINT uType
);
469 BOOL16 WINAPI
mciFreeCommandResource16(UINT16 uTable
);
470 BOOL WINAPI
mciFreeCommandResource(UINT uTable
);
472 HINSTANCE16 WINAPI
mmTaskCreate16(SEGPTR spProc
, HINSTANCE16
*lphMmTask
, DWORD dwPmt
);
473 void WINAPI
mmTaskBlock16(HINSTANCE16 hInst
);
474 LRESULT WINAPI
mmTaskSignal16(HTASK16 ht
);
475 void WINAPI
mmTaskYield16(void);
477 LRESULT WINAPI
mmThreadCreate16(FARPROC16 fpThreadAddr
, LPHANDLE lpHndl
,
478 DWORD dwPmt
, DWORD dwFlags
);
479 void WINAPI
mmThreadSignal16(HANDLE16 hndl
);
480 void WINAPI
mmThreadBlock16(HANDLE16 hndl
);
481 HANDLE16 WINAPI
mmThreadGetTask16(HANDLE16 hndl
);
482 BOOL16 WINAPI
mmThreadIsValid16(HANDLE16 hndl
);
483 BOOL16 WINAPI
mmThreadIsCurrent16(HANDLE16 hndl
);
485 #define DCB_NULL 0x0000
486 #define DCB_WINDOW 0x0001 /* dwCallback is a HWND */
487 #define DCB_TASK 0x0002 /* dwCallback is a HTASK */
488 #define DCB_FUNCTION 0x0003 /* dwCallback is a FARPROC */
489 #define DCB_EVENT 0x0005 /* dwCallback is an EVENT Handler */
490 #define DCB_TYPEMASK 0x0007
491 #define DCB_NOSWITCH 0x0008 /* don't switch stacks for callback */
493 BOOL16 WINAPI
DriverCallback16(DWORD dwCallBack
, UINT16 uFlags
, HANDLE16 hDev
,
494 WORD wMsg
, DWORD dwUser
, DWORD dwParam1
, DWORD dwParam2
);
495 BOOL WINAPI
DriverCallback(DWORD dwCallBack
, UINT uFlags
, HANDLE hDev
,
496 UINT wMsg
, DWORD dwUser
, DWORD dwParam1
, DWORD dwParam2
);
500 #endif /* __MMDDK_H */