MCI_SEEK

  • Article

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.

To send this command, call the mciSendCommand function with the following parameters.

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 Flags.

lpSeek

Pointer to 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.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Mmsystem.h; include Windows.h.

See Also

MCI, MCI Commands, MCI_SEEK_PARMS, MCI_SET, MCI_VCR_SEEK_PARMS