This
parameter can contain any of the following flags with the following limitation.
The MCI_CUE_INPUT and MCI_CUE_OUTPUT flags are mutually exclusive.
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_CUE_INPUT
This
flag cues or prerolls the device instance for input or recording.
MCI_CUE_OUTPUT
This flag cues or prerolls the device instance
for output or playback.
Digital Video Extensions
The following additional flags apply to digital video devices. These flags
are only valid when cueing the device instance for output. The MCI_NOSHOW
and MCI_SHOW flags are mutually exclusive.
MCI_NOSHOW
This flag causes the window to be hidden
while the cue operation is performed. This is the default. If MCI_TO is
not also specified, the media position will remain unchanged.
MCI_SHOW
This flag causes the window to be displayed while
the cue operation is performed. If MCI_TO is not also specified, the current
frame is displayed and the media position will advance by one (frame).
MCI_TO
This flag enables seeking to a specific location
in the media while cueing the device for playback. If this flag is specified,
the ulTo field of MCI_SEEK_PARMS
indicates 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.
Wave Audio Extensions
The following additional flags apply to wave audio devices. The MCI_WAVE_INPUT
and MCI_WAVE_OUTPUT flags are mutually exclusive.
MCI_WAVE_INPUT
This flag cues or prerolls the device
instance for input or recording.
MCI_WAVE_OUTPUT
This flag cues or prerolls the device instance
for output or playback.
pParam2 (PMCI_GENERIC_PARMS)
A pointer to the default media control interface
parameter data structure. Devices with extended command sets might replace
this pointer with a pointer to a device-specific data structure as follows:
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 ID is currently inactive. Issue MCI_ACQUIREDEVICE
to make device ID 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_FILE_NOT_FOUND
File has not been loaded.
MCIERR_UNSUPPORTED_FUNCTION
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
[Back]
[Next]