MCI_SEEK
The MCI_SEEK
command changes the current position in the content as quickly as possible.
Video and audio output are disabled during the seek. After the seek is
complete, the device is stopped. CD audio, digital-video, MIDI sequencer, VCR,
videodisc, and waveform-audio devices recognize this command.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID,
MCI_SEEK,
DWORD dwFlags, (DWORD)
(LPMCI_SEEK_PARMS) lpSeek);
Parameters
wDeviceID
Device
identifier of the MCI device that is to receive the command message.
dwFlags
MCI_NOTIFY,
MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For information about
these flags, see The Wait, Notify, and Test Flags4FW.04J.
lpSeek
Address of an
MCI_SEEK_PARMS
structure. (Devices with extended command sets might replace this structure
with a device-specific structure.)
Return Values
Returns zero
if successful or an error otherwise.
Remarks
If a data
sample size for a device is larger than 1 byte (such as with waveform-audio
stereo data), this command moves to the beginning of the nearest sample
when a specified position does not coincide with the start of a sample.
The following
additional flags apply to all devices supporting MCI_SEEK:
MCI_SEEK_TO_END
Seek to the
end of the content.
MCI_SEEK_TO_START
Seek to the
beginning of the content.
MCI_TO
A position is
included in the dwTo member of the structure identified by lpSeek.
The units assigned to the position values are specified with the
MCI_SET_TIME_FORMAT flag of the MCI_SET command. Do not use this flag with
MCI_SEEK_TO_END or MCI_SEEK_TO_START.
The following
additional flags are used with the vcr device type:
MCI_VCR_SEEK_AT
The dwAt member
of the structure identified by lpSeek contains a time when the entire
command begins.
MCI_VCR_SEEK_MARK
The dwMark
member of the structure identified by lpSeek contains the numbered
mark to search for.
MCI_VCR_SEEK_REVERSE
Seek
direction is reverse; this is used only with the MCI_VCR_SEEK_MARK flag.
For VCR
devices, the lpSeek parameter points to an MCI_VCR_SEEK_PARMS structure.
The following
additional flag is used with the videodisc device type:
MCI_VD_SEEK_REVERSE
Seek
direction is reverse.
See Also