object

      Object associated with this media control interface command. The object can be one of the following:

      • Device type
      • Device name
      • Filename
      • Alias
      AUDIO
        Specifies the audio attributes of the device context determined by the ALL, LEFT, RIGHT, OVER and VOLUME keywords.

        ALL

          Applies to both or all of the channels (default).

          Specify ON or OFF with the ALL keyword.

          ON

            Enables audio.
          OFF
            Disables audio.
          LEFT
            Applies to the left channel.

            Specify ON or OFF with the LEFT keyword.

            ON

              Enables audio to the left channel.
            OFF
              Disables audio to the left channel.
            RIGHT
              Applies to the right channel.

              Specify ON or OFF with the RIGHT keyword.

              ON

                Enables audio to the right channel.
              OFF
                Disables audio to the right channel.
              OVER milliseconds
                Applies the change over the specified time period (fade).
              VOLUME percentage
                Sets the volume level.
              BITSPERSAMPLE integer
                The number of bits per sample to be played or recorded. The file is saved in this format.
              BYTESPERSEC integer
                The average number of bytes per second to be played or recorded. The file is saved in this format.
              CHANNELS integer
                The channel count for playing and recording. The file is saved in this format.
              FORMAT TAG tag
                The format type for playing and recording. The file is saved in this format. If the waveform format is being changed then the SET command should be sent first with the FORMAT TAG keyword specified as the driver might need to change the other settings to be compatible with the new waveform format. After setting the waveform format, the other parameters can be set as necessary within the currently selected waveform format. An error will be returned if the requested change results in an unsupported configuration.

                An application can use the STATUS message to see if any of the other settings were changed to maintain a valid configuration. The following tag values are defined:

                pcm

                  The format type of PCM (pulse code modulation) for playing and recording. The file is saved in this format.
                avc adpcm
                  The IBM AVC ADPCM (adaptive differential pulse code modulation) format type for playing and recording. The file is saved in this format.
                microsoft adpcm
                  The Microsoft ADPCM format type for playing and recording. The file is saved in this format.
                cvsd
                  The IBM Speech Viewer format type for playing and recording. The file is saved in this format.
                alaw
                  The CCITT A-Law format type for playing and recording. The file is saved in this format.
                mulaw
                  The CCITT MuLaw format type for playing and recording. The file is saved in this format.
                ibm alaw
                  The IBM A-Law format type for playing and recording. This format type is the same as CCITT A-Law.
                ibm mulaw
                  The IBM A-Law format type for playing and recording. This format type is the same as CCITT Mulaw.
                ibm adpcm
                  The IBM ADPCM format type for playing and recording. The file is saved in this format.
                oki adpcm
                  The OKI ADPCM format type for playing and recording. The file is saved in this format.
                dvi adpcm
                  The DVI ADPCM format type for playing and recording. The file is saved in this format.
                ct adpcm
                  The format type of Creative Labs ADPCM for playing and recording. The file is saved in this format.
                digistd
                  The IBM Digispeech standard format type for playing and recording. The file is saved in this format.
                digifix
                  The IBM Digispeech fixed format type for playing and recording. The file is saved in this format.
                SAMPLESPERSEC integer
                  The sample rate for playing and recording. The file is saved in this format.
                TIME FORMAT BYTES
                  Sets the time format to bytes. All position information is specified as bytes following this command.
                TIME FORMAT MILLISECONDS
                  Sets the time format to milliseconds. All position information is specified as milliseconds following this command. You can abbreviate milliseconds as ms.
                TIME FORMAT MMTIME
                  Set the time format to MMTIME.
                TIME FORMAT SAMPLES
                  Sets the time format to samples. All position information is specified as samples following this command.
                WAIT
                  The command is executed synchronously. The function waits until the requested action is complete before returning to the application.
                NOTIFY
                  The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

                [Back] [Next]