MCI_SEEK

This MCI command message positions the workspace to the specified position showing the specified frame.

Parameters

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 that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that the seek operation should finish before MCI returns control to the application.

MCI_SEEK_TO_END

Specifies that the device should move the position to the end of the workspace. If seek exactly is off, this might seek to the last key-frame image. Do not use this flag with MCI_TO.

MCI_SEEK_TO_START

Specifies that the device should move the position to the beginning of the workspace. Do not use this flag with MCI_TO.

MCI_TO

Specifies a position value is included in the dwTo field of the MCI_SEEK_PARMS data structure. The position specifies the desired new location in units of the current time format. If seeking exactly is disabled, then seeking positions at approximately the requested frame. In general, if the requested frame is interframe-encoded, the seek will position at a nearby, previous key-frame image. There are two exceptions to this positioning rule.

The first exception is if the position follows the current position but is before the next key-frame image, the device maintains the current position.

The second exception applies to newly recorded files that have not been saved. Some devices may position the workspace at the first frame of the new data.

LPMCI_SEEK_PARMS lParam2

Specifies a far pointer to the MCI_SEEK_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

Video and audio output are disabled during the seek. Depending on the device, the mode after a seek is either paused or stopped.

See Also

MCI_PLAY, MCI_RECORD