home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / os2tk45 / samples / mm / mcistrng / mcistrng.ipf < prev    next >
Text File  |  1999-05-11  |  6KB  |  144 lines
  1. :userdoc.
  2. :h1 res=001.Help for String Test
  3. :p.
  4. The String Test sample program allows the user to control any media device
  5. that is
  6. installed on the system.  String Test
  7. accepts Media Control Interface string commands from the user, and
  8. passes them on to the appropriate multimedia component for execution.
  9. There are three ways to pass string commands to MMPM/2 using String Test.
  10. :p.
  11. The first way
  12. is to type a string command in the
  13. the :hp2.String command:ehp2. entry field on
  14. the String Test main window.
  15. The valid format for a string command is <COMMAND> <DEVICE> <PARAMETERS>.
  16. For example, the following three string commands will play a waveform
  17. file that resides in the current directory:
  18. :ul compact.
  19. :li."open filename.wav alias xxx"
  20. :li."play xxx notify"
  21. :li."close xxx"
  22. :eul.
  23. :p.
  24. Select the :hp2.Send:ehp2. push button to send the string command
  25. to
  26. the appropriate multimedia component for execution.  In the example above,
  27. pressing the :hp2.Send:ehp2. push button after each string command
  28. would send each command
  29. to the wave audio device.
  30. Selecting the :hp2.Send:ehp2. push button will also add the string command
  31. to the list box below the :hp2.String command:ehp2.
  32. entry field.  The user may scroll through this list box and select a command
  33. from it in order to complete the :hp2.String command:ehp2. entry field.
  34. :p.
  35. The second way to send string commands
  36. is to specify a batch file of string commands as a command line parameter
  37. when starting String Test from an OS/2 command prompt.
  38. The batch file of string commands is simply a text file, with any valid
  39. filename, that has one string
  40. command on each line.
  41. :p.
  42. For example, if the name of the
  43. batch file is test.dat, the correct way to start String Test
  44. and have it execute the string commands in test.dat would be to type
  45. "mcistrng test.dat"
  46. from an OS/2 command line.
  47. String Test will process each string command in the batch file as if it
  48. had been typed in the :hp2.String command:ehp2. entry field
  49. on String Test's main window.
  50. :p.
  51. The third way to send string commands using String Test
  52. also involves a batch file of string commands.
  53. In addition to executing a batch file of string commands by
  54. specifying a command line parameter to String Test, a batch
  55. file of string commands may also be executed by
  56. selecting the :hp2.Batch file:ehp2. push button on String Test's main window.
  57. When this push button is selected, a dialog box will be displayed allowing
  58. a file to be selected.  The selected file can then be executed as a batch
  59. file of String Commands.
  60. :p.
  61. For more information about string commands, please refer to the MMPM/2
  62. Programmer's
  63. Reference.
  64. :p.
  65. Select the :hp2.Send:ehp2. push button to send the string command that was
  66. just entered in the :hp2.String command:ehp2. entry field to
  67. the appropriate multimedia component for execution.
  68. :p.
  69. Select the :hp2.Display messages:ehp2. push button to display a pop-up
  70. window containing notification messages that String Test
  71. is receiving from media devices.
  72. :p.
  73. Select the :hp2.Batch file:ehp2. push button to display a pop-up window
  74. that allows a batch file of string commands to be selected and executed.
  75. :p.
  76. Select the :hp2.Cancel:ehp2. push button to end the application.
  77. :p.
  78. Select the :hp2.Help:ehp2. push button to view this help panel.
  79. .*********************************************************************
  80. :h1 res=002.Help for Display Messages
  81. :p.The Media Control Interface returns asynchronous response messages
  82. to applications to indicate
  83. such things as completion of a media device function or the passing of
  84. ownership of a media device from one process to another.
  85. :p.
  86. Notification messages that are received by the String Test utility are
  87. shown in the :hp2.Notification messages:ehp2. list.  This list is only for
  88. displaying information to the user.  It does not allow any selections
  89. to be made.
  90. :p.
  91. Select the :hp2.Include:ehp2. push button to display a pop-up
  92. window which allows the user to filter the notification messages that
  93. are displayed in this window.
  94. :p.
  95. Select the :hp2.Cancel:ehp2. push button to remove this pop-up window.
  96. :p.
  97. Select the :hp2.Help:ehp2. push button to view this help panel.
  98. .**********************************************************************
  99. :h1 res=003.Help for Include Messages
  100. :p.
  101. Filter the incoming notification messages to be shown in the
  102. :hp2.Display Messages:ehp2. pop-up window by checking the check
  103. boxes next to the corresponding messages to be shown.
  104. If none of these check boxes are selected then no messages will be shown
  105. in the :hp2.Display Messages:ehp2. pop-up window.
  106. :p.
  107. An MM_MCINOTIFY message is returned to an application when a device
  108. successfully completes the action indicated by the message, or when
  109. an error occurs.
  110. :p.
  111. An MM_MCIPASSDEVICE message notifies an application that the use of a media
  112. device
  113. is being gained or lost.
  114. :p.
  115. An MM_MCIPOSITIONCHANGE message notifies an application of the current media
  116. position of the media device.  This message is generated periodically when the
  117. MCI_SET_POSITION_ADVISE message is sent to the media device.
  118. :p.
  119. An MM_MCICUEPOINT message notifies an application that the device has
  120. encountered a cuepoint.
  121. :p.
  122. An MM_MCIPLAYLISTMESSAGE message notifies the application that the playlist
  123. processor has encountered a MESSAGE instruction.
  124. :p.
  125. An MM_MCIEVENT message notifies an application of an event generated by a
  126. device.
  127. :p.
  128. Select the :hp2.Include:ehp2 push button after selecting the desired
  129. checkboxes.  This action will set the appropriate filters for the
  130. :hp2.Display Messages:ehp2. pop-up window and will remove this pop-up
  131. window.
  132. :p.
  133. Select the :hp2.Cancel:ehp2. remove this pop-up window without saving any
  134. of the checkbox selections made.
  135. :p.
  136. Select the :hp2.Help:ehp2. push button to view this help panel.
  137. .**********************************************************************
  138. :h1 res=004.Help for Open and execute batch file
  139. :p.
  140. Choose the desired batch file of string commands from the pop-up
  141. window, and then select the :hp2.Execute batch file:ehp2. push button
  142. to execute the selected batch file.
  143. :euserdoc.
  144.