include/mmddk.h

   1 /* -*- tab-width: 8; c-basic-offset: 4 -*- */
   2
   3 /*****************************************************************************
   4  * Copyright 1998, Luiz Otavio L. Zorzella
   5  *           1999, Eric Pouech
   6  *
   7  * File:      mmddk.h
   8  * Purpose:   multimedia declarations (external to WINMM & MMSYSTEM DLLs
   9  *                                     for other DLLs (MCI, drivers...))
  10  *
  11  *****************************************************************************
  12  */
  13 #ifndef __MMDDK_H
  14 #define __MMDDK_H
  15
  16 #include "mmsystem.h"
  17 #include "winbase.h"
  18
  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.
  24  */
  25 #define MAX_MIDIOUTDRV  (16)
  26
  27 /* ==================================
  28  *   Multimedia DDK compatible part
  29  * ================================== */
  30
  31 #include "pshpack1.h"
  32
  33 #define DRVM_INIT               100
  34 #define DRVM_EXIT               101
  35 #define DRVM_DISABLE            102
  36 #define DRVM_ENABLE             103
  37
  38 /* messages that have IOCTL format
  39  *    dw1 = NULL or handle
  40  *    dw2 = NULL or ptr to DRVM_IOCTL_DATA
  41  *    return is MMRESULT
  42  */
  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)
  47 typedef struct {
  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;
  51
  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
  55  */
  56 #define DRVM_IOCTL_CMD_USER   0x00000000L
  57 #define DRVM_IOCTL_CMD_SYSTEM 0x80000000L
  58
  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)
  63
  64 #define WODM_INIT               DRVM_INIT
  65 #define WODM_GETNUMDEVS          3
  66 #define WODM_GETDEVCAPS          4
  67 #define WODM_OPEN                5
  68 #define WODM_CLOSE               6
  69 #define WODM_PREPARE             7
  70 #define WODM_UNPREPARE           8
  71 #define WODM_WRITE               9
  72 #define WODM_PAUSE              10
  73 #define WODM_RESTART            11
  74 #define WODM_RESET              12
  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
  83
  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
  88
  89 #define WIDM_INIT               DRVM_INIT
  90 #define WIDM_GETNUMDEVS         50
  91 #define WIDM_GETDEVCAPS         51
  92 #define WIDM_OPEN               52
  93 #define WIDM_CLOSE              53
  94 #define WIDM_PREPARE            54
  95 #define WIDM_UNPREPARE          55
  96 #define WIDM_ADDBUFFER          56
  97 #define WIDM_START              57
  98 #define WIDM_STOP               58
  99 #define WIDM_RESET              59
 100 #define WIDM_GETPOS             60
 101
 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
 106
 107 #define MODM_INIT               DRVM_INIT
 108 #define MODM_GETNUMDEVS         1
 109 #define MODM_GETDEVCAPS         2
 110 #define MODM_OPEN               3
 111 #define MODM_CLOSE              4
 112 #define MODM_PREPARE            5
 113 #define MODM_UNPREPARE          6
 114 #define MODM_DATA               7
 115 #define MODM_LONGDATA           8
 116 #define MODM_RESET              9
 117 #define MODM_GETVOLUME          10
 118 #define MODM_SETVOLUME          11
 119 #define MODM_CACHEPATCHES       12
 120 #define MODM_CACHEDRUMPATCHES   13
 121
 122 #define MIDM_INIT               DRVM_INIT
 123 #define MIDM_GETNUMDEVS         53
 124 #define MIDM_GETDEVCAPS         54
 125 #define MIDM_OPEN               55
 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
 131 #define MIDM_STOP               61
 132 #define MIDM_RESET              62
 133
 134
 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
 140
 141 #define MXDM_GETNUMDEVS         1
 142 #define MXDM_GETDEVCAPS         2
 143 #define MXDM_OPEN               3
 144 #define MXDM_CLOSE              4
 145 #define MXDM_GETLINEINFO        5
 146 #define MXDM_GETLINECONTROLS    6
 147 #define MXDM_GETCONTROLDETAILS  7
 148 #define MXDM_SETCONTROLDETAILS  8
 149
 150 #define MCI_MAX_DEVICE_TYPE_LENGTH 80
 151
 152 #define MCI_FALSE                       (MCI_STRING_OFFSET + 19)
 153 #define MCI_TRUE                        (MCI_STRING_OFFSET + 20)
 154
 155 #define MCI_FORMAT_RETURN_BASE          MCI_FORMAT_MILLISECONDS_S
 156 #define MCI_FORMAT_MILLISECONDS_S       (MCI_STRING_OFFSET + 21)
 157 #define MCI_FORMAT_HMS_S                (MCI_STRING_OFFSET + 22)
 158 #define MCI_FORMAT_MSF_S                (MCI_STRING_OFFSET + 23)
 159 #define MCI_FORMAT_FRAMES_S             (MCI_STRING_OFFSET + 24)
 160 #define MCI_FORMAT_SMPTE_24_S           (MCI_STRING_OFFSET + 25)
 161 #define MCI_FORMAT_SMPTE_25_S           (MCI_STRING_OFFSET + 26)
 162 #define MCI_FORMAT_SMPTE_30_S           (MCI_STRING_OFFSET + 27)
 163 #define MCI_FORMAT_SMPTE_30DROP_S       (MCI_STRING_OFFSET + 28)
 164 #define MCI_FORMAT_BYTES_S              (MCI_STRING_OFFSET + 29)
 165 #define MCI_FORMAT_SAMPLES_S            (MCI_STRING_OFFSET + 30)
 166 #define MCI_FORMAT_TMSF_S               (MCI_STRING_OFFSET + 31)
 167
 168 #define MCI_VD_FORMAT_TRACK_S           (MCI_VD_OFFSET + 5)
 169
 170 #define WAVE_FORMAT_PCM_S               (MCI_WAVE_OFFSET + 0)
 171 #define WAVE_MAPPER_S                   (MCI_WAVE_OFFSET + 1)
 172
 173 #define MCI_SEQ_MAPPER_S                (MCI_SEQ_OFFSET + 5)
 174 #define MCI_SEQ_FILE_S                  (MCI_SEQ_OFFSET + 6)
 175 #define MCI_SEQ_MIDI_S                  (MCI_SEQ_OFFSET + 7)
 176 #define MCI_SEQ_SMPTE_S                 (MCI_SEQ_OFFSET + 8)
 177 #define MCI_SEQ_FORMAT_SONGPTR_S        (MCI_SEQ_OFFSET + 9)
 178 #define MCI_SEQ_NONE_S                  (MCI_SEQ_OFFSET + 10)
 179 #define MIDIMAPPER_S                    (MCI_SEQ_OFFSET + 11)
 180
 181 #define MCI_RESOURCE_RETURNED       0x00010000  /* resource ID */
 182 #define MCI_COLONIZED3_RETURN       0x00020000  /* colonized ID, 3 bytes data */
 183 #define MCI_COLONIZED4_RETURN       0x00040000  /* colonized ID, 4 bytes data */
 184 #define MCI_INTEGER_RETURNED        0x00080000  /* integer conversion needed */
 185 #define MCI_RESOURCE_DRIVER         0x00100000  /* driver owns returned resource */
 186
 187 #define MCI_NO_COMMAND_TABLE    0xFFFF
 188
 189 #define MCI_COMMAND_HEAD        0
 190 #define MCI_STRING              1
 191 #define MCI_INTEGER             2
 192 #define MCI_END_COMMAND         3
 193 #define MCI_RETURN              4
 194 #define MCI_FLAG                5
 195 #define MCI_END_COMMAND_LIST    6
 196 #define MCI_RECT                7
 197 #define MCI_CONSTANT            8
 198 #define MCI_END_CONSTANT        9
 199
 200 #define MAKEMCIRESOURCE(wRet, wRes) MAKELRESULT((wRet), (wRes))
 201
 202 typedef struct {
 203         DWORD                   dwCallback;
 204         DWORD                   dwInstance;
 205         HMIDIOUT                hMidi;
 206         DWORD                   dwFlags;
 207 } PORTALLOC16, *LPPORTALLOC16;
 208
 209 typedef struct {
 210         DWORD                   dwCallback;
 211         DWORD                   dwInstance;
 212         HMIDIOUT                hMidi;
 213         DWORD                   dwFlags;
 214 } PORTALLOC, *LPPORTALLOC;
 215
 216 #if 0
 217 /* FIXME: the ???OPENDESC structs will be fixed when low
 218  * level driver loading is available
 219  * for now comment them out, and use non corrrect ones in winemm.h
 220  * to be uncommented ASAP
 221  */
 222 typedef struct {
 223         HWAVE16                 hWave;
 224         LPWAVEFORMATEX          lpFormat;
 225         DWORD                   dwCallback;
 226         DWORD                   dwInstance;
 227         UINT16                  uMappedDeviceID;
 228         DWORD                   dnDevNode;
 229 } WAVEOPENDESC16, *LPWAVEOPENDESC16;
 230
 231 typedef struct {
 232         HWAVE                   hWave;
 233         LPWAVEFORMATEX          lpFormat;
 234         DWORD                   dwCallback;
 235         DWORD                   dwInstance;
 236         UINT                    uMappedDeviceID;
 237         DWORD                   dnDevNode;
 238 } WAVEOPENDESC, *LPWAVEOPENDESC;
 239
 240 typedef struct {
 241         DWORD                   dwStreamID;
 242         WORD                    wDeviceID;
 243 } MIDIOPENSTRMID;
 244
 245 typedef struct {
 246         HMIDI16                 hMidi;
 247         DWORD                   dwCallback;
 248         DWORD                   dwInstance;
 249         UINT16                  reserved;
 250         DWORD                   dnDevNode;
 251         DWORD                   cIds;
 252         MIDIOPENSTRMID          rgIds;
 253 } MIDIOPENDESC16, *LPMIDIOPENDESC16;
 254
 255 typedef struct {
 256         HMIDI                   hMidi;
 257         DWORD                   dwCallback;
 258         DWORD                   dwInstance;
 259         DWORD                   dnDevNode;
 260         DWORD                   cIds;
 261         MIDIOPENSTRMID          rgIds;
 262 } MIDIOPENDESC, *LPMIDIOPENDESC;
 263
 264 #if 0
 265 typedef struct {
 266         UINT16                  wDelay;
 267         UINT16                  wResolution;
 268         LPTIMECALLBACK16        lpFunction;
 269         DWORD                   dwUser;
 270         UINT16                  wFlags;
 271 } TIMEREVENT, *LPTIMEREVENT;
 272 #endif
 273
 274 typedef struct tMIXEROPENDESC16
 275 {
 276         HMIXEROBJ16             hmx;
 277         LPVOID                  pReserved0;
 278         DWORD                   dwCallback;
 279         DWORD                   dwInstance;
 280 } MIXEROPENDESC16, *LPMIXEROPENDESC16;
 281
 282 typedef struct tMIXEROPENDESC
 283 {
 284         HMIXEROBJ               hmx;
 285         LPVOID                  pReserved0;
 286         DWORD                   dwCallback;
 287         DWORD                   dwInstance;
 288 } MIXEROPENDESC, *LPMIXEROPENDESC;
 289 #else
 290 /* those definitions are still wine tainted
 291  * keep them in a temporary phase
 292  */
 293 typedef struct {
 294         HWAVE16                 hWave;
 295         LPWAVEFORMAT            lpFormat;
 296         DWORD                   dwCallBack;
 297         DWORD                   dwInstance;
 298         UINT16                  uDeviceID;
 299 } WAVEOPENDESC, *LPWAVEOPENDESC;
 300
 301 typedef struct {
 302         DWORD                   dwStreamID;
 303         WORD                    wDeviceID;
 304 } MIDIOPENSTRMID;
 305
 306 /* FIXME: this structure has a different mapping in 16 & 32 bit mode
 307  * Since, I don't plan to add support for native 16 bit low level
 308  * multimedia drivers, it'll do.
 309  */
 310 typedef struct {
 311         HMIDI16                 hMidi;
 312         DWORD                   dwCallback;
 313         DWORD                   dwInstance;
 314         UINT16                  wDevID;
 315         DWORD                   dnDevNode;
 316         DWORD                   cIds;
 317         MIDIOPENSTRMID          rgIds;
 318 } MIDIOPENDESC, *LPMIDIOPENDESC;
 319
 320 typedef struct tMIXEROPENDESC
 321 {
 322         HMIXEROBJ16             hmx;
 323         DWORD                   dwCallback;
 324         DWORD                   dwInstance;
 325         UINT16                  uDeviceID;
 326 } MIXEROPENDESC,*LPMIXEROPENDESC;
 327 #endif
 328
 329 typedef struct {
 330         UINT16                  wDeviceID;              /* device ID */
 331         LPSTR                   lpstrParams;            /* parameter string for entry in SYSTEM.INI */
 332         UINT16                  wCustomCommandTable;    /* custom command table (0xFFFF if none)
 333                                                          * filled in by the driver */
 334         UINT16                  wType;                  /* driver type (filled in by the driver) */
 335 } MCI_OPEN_DRIVER_PARMS16, *LPMCI_OPEN_DRIVER_PARMS16;
 336
 337 typedef struct {
 338         UINT                    wDeviceID;              /* device ID */
 339         LPSTR                   lpstrParams;            /* parameter string for entry in SYSTEM.INI */
 340         UINT                    wCustomCommandTable;    /* custom command table (0xFFFF if none) * filled in by the driver */
 341         UINT                    wType;                  /* driver type (filled in by the driver) */
 342 } MCI_OPEN_DRIVER_PARMSA, *LPMCI_OPEN_DRIVER_PARMSA;
 343
 344 typedef struct {
 345         UINT                    wDeviceID;              /* device ID */
 346         LPWSTR                  lpstrParams;            /* parameter string for entry in SYSTEM.INI */
 347         UINT                    wCustomCommandTable;    /* custom command table (0xFFFF if none) * filled in by the driver */
 348         UINT                    wType;                  /* driver type (filled in by the driver) */
 349 } MCI_OPEN_DRIVER_PARMSW, *LPMCI_OPEN_DRIVER_PARMSW;
 350 DECL_WINELIB_TYPE_AW(MCI_OPEN_DRIVER_PARMS)
 351 DECL_WINELIB_TYPE_AW(LPMCI_OPEN_DRIVER_PARMS)
 352
 353 DWORD                   WINAPI  mciGetDriverData16(UINT16 uDeviceID);
 354 DWORD                   WINAPI  mciGetDriverData(UINT uDeviceID);
 355
 356 BOOL16                  WINAPI  mciSetDriverData16(UINT16 uDeviceID, DWORD dwData);
 357 BOOL                    WINAPI  mciSetDriverData(UINT uDeviceID, DWORD dwData);
 358
 359 UINT16                  WINAPI  mciDriverYield16(UINT16 uDeviceID);
 360 UINT                    WINAPI  mciDriverYield(UINT uDeviceID);
 361
 362 BOOL16                  WINAPI  mciDriverNotify16(HWND16 hwndCallback, UINT16 uDeviceID,
 363                                                   UINT16 uStatus);
 364 BOOL                    WINAPI  mciDriverNotify(HWND hwndCallback, UINT uDeviceID,
 365                                                 UINT uStatus);
 366
 367 UINT16                  WINAPI  mciLoadCommandResource16(HINSTANCE16 hInstance,
 368                                                  LPCSTR lpResName, UINT16 uType);
 369 UINT                    WINAPI  mciLoadCommandResource(HINSTANCE hInstance,
 370                                                LPCWSTR lpResName, UINT uType);
 371
 372 BOOL16                  WINAPI  mciFreeCommandResource16(UINT16 uTable);
 373 BOOL                    WINAPI  mciFreeCommandResource(UINT uTable);
 374
 375 HINSTANCE16             WINAPI  mmTaskCreate16(SEGPTR spProc, HINSTANCE16 *lphMmTask, DWORD dwPmt);
 376 void                    WINAPI  mmTaskBlock16(HINSTANCE16 hInst);
 377 LRESULT                 WINAPI  mmTaskSignal16(HTASK16 ht);
 378 void                    WINAPI  mmTaskYield16(void);
 379
 380 LRESULT                 WINAPI  mmThreadCreate16(FARPROC16 fpThreadAddr, LPHANDLE lpHndl,
 381                                                  DWORD dwPmt, DWORD dwFlags);
 382 void                    WINAPI  mmThreadSignal16(HANDLE16 hndl);
 383 void                    WINAPI  mmThreadBlock16(HANDLE16 hndl);
 384 HANDLE16                WINAPI  mmThreadGetTask16(HANDLE16 hndl);
 385 BOOL16                  WINAPI  mmThreadIsValid16(HANDLE16 hndl);
 386 BOOL16                  WINAPI  mmThreadIsCurrent16(HANDLE16 hndl);
 387
 388 #define DCB_NULL                0x0000
 389 #define DCB_WINDOW              0x0001                  /* dwCallback is a HWND */
 390 #define DCB_TASK                0x0002                  /* dwCallback is a HTASK */
 391 #define DCB_FUNCTION            0x0003                  /* dwCallback is a FARPROC */
 392 #define DCB_EVENT               0x0005                  /* dwCallback is an EVENT Handler */
 393 #define DCB_TYPEMASK            0x0007
 394 #define DCB_NOSWITCH            0x0008                  /* don't switch stacks for callback */
 395
 396 BOOL16                  WINAPI  DriverCallback16(DWORD dwCallBack, UINT16 uFlags, HANDLE16 hDev,
 397                                                  WORD wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
 398 BOOL                    WINAPI  DriverCallback(DWORD dwCallBack, UINT uFlags, HANDLE hDev,
 399                                                UINT wMsg, DWORD dwUser, DWORD dwParam1, DWORD dwParam2);
 400
 401 /* FIXME: the Wine builtin MCI drivers still use those winmm internal functions
 402  *              remove them ASAP
 403  */
 404 extern DWORD                    MCI_WriteString(LPSTR lpDstStr, DWORD dstSize, LPCSTR lpSrcStr);
 405 extern const char*              MCI_MessageToString(UINT16 wMsg);
 406 extern DWORD                    MCI_SendCommandAsync(UINT wDevID, UINT wMsg, DWORD dwParam1, DWORD dwParam2, UINT size);
 407
 408
 409 #include "poppack.h"
 410
 411 #endif /* __MMDDK_H */
 412