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