home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / header45.zip / mcidrv.h < prev    next >
C/C++ Source or Header  |  1999-03-15  |  16KB  |  319 lines
  1. /****************************************************************************/
  2. /*                                                                          */
  3. /* Module Name: MCIDRV.H                                                    */
  4. /*                                                                          */
  5. /* This is the multimedia include file that has the typedefs, defines and   */
  6. /* function prototyes for MCI drivers.                                      */
  7. /*                                                                          */
  8. /* Copyright (c) International Business Machines Corporation 1991, 1992     */
  9. /*                        All Rights Reserved                               */
  10. /*                                                                          */
  11. /****************************************************************************/
  12. #ifdef __cplusplus
  13.    extern "C" {
  14. #endif
  15.  
  16. #ifndef _MCIDRV_H
  17. #define _MCIDRV_H
  18.  
  19. #ifndef _SSM_H_
  20. #include <ssm.h>
  21. #endif
  22.  
  23. typedef    USHORT   GID;
  24.  
  25. /****************************************************************************/
  26. /*             MCI Driver  message identifiers                              */
  27. /****************************************************************************/
  28. #define MCIDRV_SAVE                 900
  29. #define MCIDRV_RESTORE              901
  30. #define MCIDRV_SYNC                 902
  31. #define MCIDRV_CHANGERESOURCE       903
  32. #define MCIDRV_CONNECT              904
  33. #define MCIDRV_ASSOCIATE            905
  34. #define MCIDRV_DISCONNECT           906
  35. #define MCIDRV_TEST_CONNECTION      907
  36. #define MCIDRV_START                908
  37. #define MCIDRV_SEEK                 909
  38. #define MCIDRV_STOP                 910
  39. #define MCIDRV_MODIFY_CONNECTION    911
  40. #define MCIDRV_INIT_CONNECTION      912
  41. #define MCIDRV_DEINIT_CONNECTION    913
  42. #define MCIDRV_ENABLE_EVENT         915
  43. #define MCIDRV_GETTIME              917
  44.  
  45. /*********************************************************************/
  46. /* The following messages are used by the MCIDRV_CONNECT message     */
  47. /*********************************************************************/
  48.  
  49. #define MCIDRV_CONNECT_TARGET       0x00010000
  50. #define MCIDRV_CONNECT_SOURCE       0x00020000
  51. #define MCIDRV_SET_CONNNECTOR_TYPE  0x00040000
  52. #define MCIDRV_CHANGE_SEM           0x00080000
  53.  
  54. /*********************************************************************/
  55. /* The following messages are used by MCIDRV_MODIFY_CONNECTION       */
  56. /*********************************************************************/
  57.  
  58.  
  59. #define MCIDRV_MODIFY_10            0x00100000  // back level MCI driver.
  60. #define MCIDRV_MIX_STANDALONE       0x00200000L
  61.  
  62.  
  63. /*********************************************************************/
  64. /* The following messages are used by MCIDRV_START                   */
  65. /*********************************************************************/
  66.  
  67. #define MCIDRV_CUE_PLAYBACK         0x00010000
  68. #define MCIDRV_CUE_RECORD           0x00020000
  69. #define MCIDRV_START_PLAYBACK       0x00040000
  70. #define MCIDRV_START_RECORD         0x00080000
  71. #define MCIDRV_START_PREROLL        0x00100000
  72.  
  73. /*********************************************************************/
  74. /* The following messages are used by MCIDRV_ASSOCIATE               */
  75. /*********************************************************************/
  76.  
  77. #define MCIDRV_OUTPUT               0x00010000
  78. #define MCIDRV_INPUT                0x00020000
  79.  
  80. /*********************************************************************/
  81. /* The following messages are used by MCIDRV_STOP                    */
  82. /*********************************************************************/
  83.  
  84. #define MCIDRV_PAUSE_STREAM_NETWORK   0x00010000
  85. #define MCIDRV_FLUSH_STREAM_NETWORK   0x00020000
  86. #define MCIDRV_DISCARD_STREAM_NETWORK 0x00040000
  87.  
  88.  
  89.  
  90. /*********************************************************************/
  91. /* The following messages are used by MCIDRV_DEINIT_CONNECTION       */
  92. /*********************************************************************/
  93.  
  94. #define MCIDRV_MODIFY_HANDLER         0x00010000
  95.  
  96.  
  97.  
  98. /*********************************************************************/
  99. /* The following range of message ID's are reserved for internal use */
  100. /*  by MCI drivers                                                   */
  101. /*********************************************************************/
  102. #define MCI_INTERNAL_MESSAGES_START    1000
  103. #define MCI_INTERNAL_MESSAGES_END      1999
  104.  
  105. /*********************************************************************/
  106. /* Flags used by the string parser for command tables                */
  107. /* NOTE: All flags must have an "L" suffix in order to be parsed as  */
  108. /* DWORDs by the resource compiler                                   */
  109. /*********************************************************************/
  110. #define MCI_COMMAND_HEAD                 0x00000001L
  111. #define MCI_END_COMMAND                  0x00000002L
  112. #define MCI_END_COMMAND_LIST             0x00000003L
  113. #define MCI_RETURN                       0x00000004L
  114. #define MCI_STRING                       0x00000005L
  115. #define MCI_FLAG                         0x00000006L
  116. #define MCI_INTEGER                      0x00000007L
  117. #define MCI_CONSTANT                     0x00000008L
  118. #define MCI_CONSTANT_INTEGER             0x00000009L
  119. #define MCI_CONSTANT_STRING              0x0000000AL
  120. #define MCI_END_CONSTANT                 0x0000000BL
  121. #define MCI_DEFAULT_STRING               0x0000000CL
  122. #define MCI_DEFAULT_INTEGER              0x0000000DL
  123. #define MCI_RETURN_TYPE                  0x0000000EL
  124. #define MCI_RETURN_TYPE_STRING           0x0000000FL
  125. #define MCI_END_RETURN_TYPE              0x00000010L
  126. #define MCI_CONSTANT_2                   0x00000011L
  127. #define MCI_END_CONSTANT_2               0x00000012L
  128. #define MCI_CONSTANT_PAIR                0x00000013L
  129. #define MCI_END_CONSTANT_PAIR            0x00000014L
  130. #define MCI_CONSTANT_INTEGER_PAIR        0x00000015L
  131. #define MCI_CONSTANT_STRING_PAIR         0x00000016L
  132. #define MCI_RECTL                        0x00000017L
  133. #define MCI_CONSTANT_4                   0x00000018L
  134. #define MCI_END_CONSTANT_4               0x00000019L
  135. #define MCI_FOURCC                       0x0000001AL
  136. #define MCI_OR                           0x0000001BL
  137. #define MCI_END_OR                       0x0000001CL
  138. #define MCI_STRING_LIST                  0x0000001DL
  139.  
  140. /*********************************************************************/
  141. /* Return types supported by mciSendString                           */
  142. /*   Values 0x0000 -> 0xFF00  are reserved by MMPM2                  */
  143. /*   Values 0xFF01 -> 0xFFFF  are user definable                     */
  144. /*********************************************************************/
  145. #define MCI_INTEGER_RETURNED                     0x1000
  146. #define MCI_COLONIZED2_RETURN                    0x2000
  147. #define MCI_COLONIZED3_RETURN                    0x3000
  148. #define MCI_COLONIZED4_RETURN                    0x4000
  149. #define MCI_TRUE_FALSE_RETURN                    0x5000
  150. #define MCI_ON_OFF_RETURN                        0x6000
  151. #define MCI_DEVICENAME_RETURN                    0x7000
  152. #define MCI_TIME_FORMAT_RETURN                   0x8000
  153. #define MCI_SPEED_FORMAT_RETURN                  0x9000
  154. #define MCI_MODE_RETURN                          0xA000
  155. #define MCI_MEDIA_TYPE_RETURN                    0xB000
  156. #define MCI_TRACK_TYPE_RETURN                    0xC000
  157. #define MCI_CONNECTOR_TYPE_RETURN                0xD000
  158. #define MCI_CDXA_CHANNEL_DESTINATION_RETURN      0xE000
  159. #define MCI_PREROLL_TYPE_RETURN                  0xF000
  160. #define MCI_FORMAT_TAG_RETURN                    0xF100
  161. #define MCI_SEQ_SYNCHRONIZATION_RETURN           0xF200
  162. #define MCI_VIDEO_QUALITY_RETURN                 0xF300
  163. #define MCI_AUDIO_QUALITY_RETURN                 0xF400
  164. #define MCI_IMAGE_QUALITY_RETURN                 0xF500
  165. #define MCI_VIDEO_COMPRESSION_RETURN             0xF600
  166. #define MCI_AUDIO_COMPRESSION_RETURN             0xF700
  167. #define MCI_IMAGE_COMPRESSION_RETURN             0xF800
  168. #define MCI_RECTL_RETURN                         0xF900
  169. #define MCI_FOURCC_RETURN                        0xFA00
  170. #define MCI_IMAGE_PELFORMAT_RETURN               0xFB00
  171. #define MCI_DIRECTION_RETURN                     0xFC00
  172. #define MCI_SIGNED_INTEGER_RETURN                0xFD00
  173.  
  174. #define MCI_USER_RETURN                          0xFF01
  175.  
  176. /*********************************************************************/
  177. /* End of msg text used by mciGetErrorString                         */
  178. /*********************************************************************/
  179. #define MCIERR_MSG_TABLE_END    MCIERR_BASE + 7000
  180.  
  181. /*********************************************************************/
  182. /*                                                                   */
  183. /*  MCI DEVICE shareability categories                               */
  184. /*                                                                   */
  185. /*********************************************************************/
  186. #define FIXEDSINGLECONTEXT            0x0001
  187. #define DYNAMICSINGLECONTEXT          0x0002
  188. #define LIMITEDMULTIPLECONTEXT        0x0003
  189. #define UNLIMITEDMULTIPLECONTEXT      0x0004
  190.  
  191. /*********************************************************************/
  192. /* MCI driver flag for close during exit list processing             */
  193. /*********************************************************************/
  194. #define MCI_CLOSE_EXIT                 0x10000000L
  195.  
  196. /*********************************************************************/
  197. /* MCI driver specific error table resource number base              */
  198. /*********************************************************************/
  199. #define MMERROR_TABLE_BASE      500
  200.  
  201. /*********************************************************************/
  202. /*                                                                   */
  203. /*  MCIDRV_CHANGERESOURCE  message flags                             */
  204. /*                                                                   */
  205. /*********************************************************************/
  206. #pragma pack(1)
  207.  
  208. typedef struct _MCIDRV_CHANGERESOURCE_PARMS {
  209.    PVOID      pInstance;             /* pointer to device instance   */
  210.    USHORT     usResourceUnits;       /* required resource units      */
  211.    USHORT     usResourceClass;       /* resource class               */
  212.    USHORT     usResourcePriority;    /* resource priority            */
  213. } MCIDRV_CHANGERESOURCE_PARMS;
  214. typedef MCIDRV_CHANGERESOURCE_PARMS  *PMCIDRV_CHANGERESOURCE_PARMS;
  215.  
  216.  
  217. /*********************************************************************/
  218. /*                                                                   */
  219. /*  MCIDRV_ENABLE_EVENT message flags                                */
  220. /*                                                                   */
  221. /*********************************************************************/
  222.  
  223. typedef struct _MCIDRV_EVENT_PARMS {
  224.    ULONG   ulLength;   /* Length of event parms                     */
  225.    PEVCB   pevcb;      /* pointer to event control block            */
  226.    PHEVENT phevent;    /* pointer to the event to enable in network */
  227.  
  228. } MCIDRV_EVENT_PARMS;
  229. typedef MCIDRV_EVENT_PARMS  *PMCIDRV_EVENT_PARMS;
  230.  
  231. /*********************************************************************/
  232. /*                                                                   */
  233. /*  MCIDRV_SYNC  message flags                                       */
  234. /*                                                                   */
  235. /*********************************************************************/
  236. #define MCIDRV_SYNC_ENABLE           0x00000100L
  237. #define MCIDRV_SYNC_DISABLE          0x00000200L
  238. #define MCIDRV_SYNC_REC_PULSE        0x00000400L
  239. #define MCIDRV_SYNC_MASTER           0x00000800L
  240. #define MCIDRV_SYNC_SET_MASTER       0x00001000L
  241.  
  242. typedef struct _MCIDRV_SYNC_PARMS {
  243.     HSTREAM   *hStreams;        /* Pointer to list of stream IDs     */
  244.     ULONG      ulNumStreams;    /* number of stream IDs              */
  245.     MMTIME     mmTime;          /* Sync Pulse Time                   */
  246.     BOOL       NonStreamMaster; /* TRUE if this device can be master */
  247.     PSYNC_EVCB pevcbSyncPulse;  /* pointer to EVCB address (output)  */
  248.     HID        hidMaster;       /* Master NULL sh ID (valid only on  */
  249.                                 /*    MCIDRV_SYNC_MASTER             */
  250.     ULONG      ulReserved1;     /* Reserved field                    */
  251.     ULONG      ulReserved2;     /* Reserved field                    */
  252. } MCIDRV_SYNC_PARMS;
  253. typedef MCIDRV_SYNC_PARMS *PMCIDRV_SYNC_PARMS;
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260. /*********************************************************************/
  261. /* contains information for open message for MCI drivers             */
  262. /*********************************************************************/
  263. typedef struct __MMDRV_OPEN_PARMS{
  264.     DWORD   dwCallback;    /* call back handle                       */
  265.     WORD    wDeviceID;     /* The device ID assigned to this instance*/
  266.     USHORT  usDeviceType;  /* The device type number                 */
  267.     USHORT  usDeviceOrd;   /* The device ordinal number              */
  268.     PVOID   pInstance;     /* pointer to the instance structure allocated */
  269.                            /* initialized by the driver. The MCI driver   */
  270.                            /* will fill in this parameter.                */
  271.     CHAR    szDevDLLName[260]; /* Character string containing the device  */
  272.                                /* specific DLL name to call for the open. */
  273.                                /* (ie. ACPA.DLL)                          */
  274.     LPSTR   lpstrElementName;/* typically a file name or NULL             */
  275.     USHORT  usDevParmLen;  /* Device parameters data block length.        */
  276.     PVOID   pDevParm;      /* Device parameters data block. This data     */
  277.                            /* block is unique to each type of device.     */
  278.                            /* (ie. LVD "COM1 9600 N 7 1").                */
  279.     ULONG   ulStructLength;           /* size of MMDRV_OPEN_PARMS */
  280.     USHORT  usResourceUnitsRequired;  /* number of resource units this instance */
  281.                                       /* requires.                              */
  282.     USHORT  usResourceClass;          /* resource class this instance belongs to*/
  283.     USHORT  usResourcePriority;       /* resource priority for this instance    */
  284.     DWORD   dwParam2;                 /* Pointer to MCI_OPEN structure          */
  285.     CHAR    szPDDName[ MAX_PDD_NAME + 1 ];  /* Name of device driver */
  286.     CHAR    szProductInfo[MAX_PRODINFO+1];  /* Product info for the driver */
  287.     ULONG   ulPID;
  288. } MMDRV_OPEN_PARMS;
  289. typedef MMDRV_OPEN_PARMS  *PMMDRV_OPEN_PARMS;
  290.  
  291.  
  292. /*********************************************************************/
  293. /*                                                                   */
  294. /*  MCIDRV_RESTORE message flags                                     */
  295. /*                                                                   */
  296. /*********************************************************************/
  297.  
  298. typedef struct _MCIDRV_RESTORE_PARMS {
  299.    ULONG   ulLength;        /* Length of restore parms               */
  300.    ULONG   ulMasterVolume;  /* Master volume value                   */
  301. } MCIDRV_RESTORE_PARMS;
  302. typedef MCIDRV_RESTORE_PARMS  *PMCIDRV_RESTORE_PARMS;
  303.  
  304.  
  305. #pragma pack()
  306. DWORD APIENTRY mdmDriverNotify (WORD    wDeviceID,
  307.                                 HWND    hwnd,
  308.                                 WORD    wMsgType,
  309.                                 WORD    wUserParm,
  310.                                 DWORD   dwMsgParm);
  311.  
  312.  
  313. #endif                          /* _MCIDRV_H */
  314.  
  315. #ifdef __cplusplus
  316. }
  317. #endif
  318.  
  319.