This message is sent to stop playback or recording.

If MCI_STOP is issued, video recording is stopped regardless of whether a TO position is reached. Once video recording is stopped, it cannot be restarted without overwriting what was previously recorded.

ulParam1 (ULONG)

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.

pParam2 (PMCI_GENERIC_PARMS)

A pointer to the default media control interface parameter data structure.

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 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
Device hardware error.
MCIERR_UNSUPPORTED_FUNCTION
Unsupported function.
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_INVALID_ITEM_FLAG
Invalid status item flag given.
MCIERR_MISSING_ITEM
Missing status item flag.
MCIERR_MISSING_PARAMETER
Required parameter is missing.

---

[Back] [Next]