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