object

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

      • Device type
      • Device name
      • Filename
      • Alias

      Note: If TRACK number is used with the keywords TYPE, COPYPERMITTED, CHANNELS, or PREEMPHASIS, then the specified track is referenced, otherwise, the current track is referenced.

      CHANNELS
        Returns the number of audio channels on the current track.
      CHANNELS TRACK number
        Returns the number of audio channels on the track.
      COPYPERMITTED
        Returns TRUE if digital copying is permitted.
      COPYPERMITTED TRACK number
        Returns TRUE if digital copying is permitted.
      CURRENT TRACK
        Returns the current track.
      LENGTH
        Returns the total length of the disc.
      LENGTH TRACK number
        Returns the length of the track specified by number.
      MEDIA PRESENT
        Returns TRUE if the media is inserted in the device; otherwise, it returns FALSE.
      MODE
        Returns the current mode of the device: not ready, stopped, playing, seeking, recording, paused, or other.
      NUMBER OF TRACKS
        Returns the number of tracks.
      POSITION
        Returns the current position.
      POSITION IN TRACK
        Returns the current position relative to the beginning of the current track.
      POSITION TRACK number
        Returns the starting position of the track specified by number.
      PREEMPHASIS
        Returns TRUE if the current track was recorded with pre-emphasis.
      PREEMPHASIS TRACK number
        Returns TRUE if the specified track was recorded with pre-emphasis.
      READY
        Returns TRUE if the device is ready.
      START POSITION
        Returns the starting position of the media.
      TIME FORMAT
        Returns the time format.
      TYPE
        Returns the track type of the current track. The track type will be returned as one of the following values:

        • audio
        • data
        • other
        TYPE TRACK number
          Returns the track type of the specified track. If the track number is not specified the current track is assumed. The track type will be returned as one of the following values:

          • audio
          • data
          • other
          VOLUME
            Returns the current volume setting. The volume is returned as a string in the format left:right where left and right are percentages of the maximum achievable effect for the left and right channels respectively. Leading zeros are suppressed for the volume level in each channel.
          WAIT
            The command is executed synchronously. The function waits until the requested action is complete before returning to the application. The WAIT keyword must be specified in order to receive return string information.
          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]