Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MCI_SEEK
 
        This MCI command message changes the current position of media
        as quickly as possible. Video and audio output are disable
        during the seek. After the seek is complete, the device will be
        stopped. Support of this message by a device is optional. The
        parameters and flags for this message vary according to the
        selected device.
 
Parameters
        DWORD dwFlags
            The following flags apply to all devices supporting
            MCI_SEEK:
 
            MCI_NOTIFY
                Specifies that MCI should post the MM_MCINOTIFY message
                when this command completes. The window to receive this
                message is specified in the dwCallback field of the data
                structure identified by lpSeek.
 
            MCI_WAIT
                Specifies that the seek operation should finish before
                MCI returns control to the application.
 
            MCI_SEEK_TO_END
                Specifies to seek to the end of the media.
 
            MCI_SEEK_TO_START
                Specifies to seek to the start of the media.
 
            MCI_TO
                Specifies a position is included in the dwTo field of the
                MCI_SEEK_PARMS data structure. The units assigned to the
                position values is specified with the
                MCI_SET_TIME_FORMAT flag of the MCI_SET command. Do not
                use this flag with MCI_SEEK_END or MCI_SEEK_START.
 
        LPMCI_SEEK_PARMS lpSeek
            Specifies a far pointer to the MCI_SEEK_PARMS data
            structure. (Devices with extended command sets might replace
            this data structure with a device-specific data structure.)
 
        Videodisc Extensions
 
        DWORD dwFlags
            The following additional flag applies to videodisc devices.
 
            MCI_VD_SEEK_REVERSE
                Specifies to seek backward.
 
        LPMCI_SEEK_PARMS lpSeek
            Specifies a far pointer to the MCI_SEEK_PARMS data
            structure.
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code.
 
See also
        MCI_PLAY, MCI_RECORD
 
                                       -♦-