MCI_SEEK

See also MCI_PLAY, MCI_RECORD

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.

DWORD lParam1

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 member of the 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 member of the MCI_SEEK_PARMS 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 lParam2

Specifies a far pointer to the MCI_SEEK_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)

Videodisc Extensions

The following additional flag for lParam1 applies to videodisc devices.

MCI_VD_SEEK_REVERSE

Specifies to seek backward.


Note that lParam2 specifies a far pointer to the MCI_SEEK_PARMS structure.