This
parameter can contain any of the following flags:
MCI_NOTIFY
A notification message will be posted
to the window specified in the hwndCallback parameter of the data
structure pointed to by the pParam2 parameter. The notification
will be posted when the action indicated by this message is completed or
when an error occurs.
MCI_WAIT
Control
is not to be returned until the action indicated by this message is completed
or an error occurs.
MCI_TO
This
flag indicates that the ulTo field of the MCI_SEEK_PARMS
data structure specifies the ending position of the seek operation.
If the ulTo position is beyond the end of the media or segment, an
MCIERR_OUTOFRANGE error is returned.
MCI_TO_START
This flag causes the device to seek to the first
playable position on the media. This is not necessarily position 0.
MCI_TO_END
This flag causes the device to seek to the end
of the media.
Digital Video Extensions
The following additional flag applies to digital video drivers.
MCI_TO_NEAREST_IFRAME
This flag causes the device
to seek to the nearest I-frame preceding the point specified by MCI_TO.
Videodisc Extensions
The following additional flag applies to videodisc device drivers.
MCI_VD_SEEK_REVERSE
This flag initiates a seek
backward.
pParam2 (PMCI_SEEK_PARMS)
rc (ULONG)
Return
codes indicating success or type of failure:
MCIERR_SUCCESS
If the function succeeds, 0 is returned.
MCIERR_INVALID_DEVICE_ID
The
device ID is not valid.
MCIERR_INSTANCE_INACTIVE
The device is currently inactive. Issue MCI_ACQUIREDEVICE
to make the device context active.
MCIERR_MISSING_FLAG
A required flag is missing.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_HARDWARE
MCIERR_UNSUPPORTED_FUNCTION
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_FILE_NOT_FOUND
File has not been loaded.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
[Back: MCI_SEEK Return Value - rc]
[Next: MCI_SEEK - Remarks]