This message pastes data from the clipboard or application buffer into a file starting at the from position. Following a paste operation the media position is at the end of the pasted data. However, after pasting into a new file, the media position will be at 0.

The MCI_CONVERT_FORMAT flag is not supported by the digital video device.

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.
MCI_FROM
Marks the beginning position of the paste operation. This position is specified in the ulFrom field of the MCI_EDIT_PARMS data structure. If MCI_FROM is not specified, the paste operation begins from the current position.
MCI_TO
Marks the ending position of the paste. The pasted data replaces data from the FROM position (or the current position if MCI_FROM is not specified) to the TO position.

If MCI_TO is not specified, the end of file is assumed and the pasted data is inserted beginning at the FROM position (or the current position if MCI_FROM is not specified).

MCI_CONVERT_FORMAT
Converts data in the clipboard to a destination format.
MCI_TO_BUFFER
Places data from the clipboard into the application's buffer. If this flag is not specified, the information is placed in a file.
MCI_FROM_BUFFER
Places data from the application's buffer into the file. If this flag is not specified, the clipboard is used as the source.

pParam2 (PMCI_EDIT_PARMS)

A pointer to the MCI_EDIT_PARMS structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

The paste was successful.
MCIERR_INVALID_BUFFER
The buffer is too small to hold data.
MCIERR_CANNOT_WRITE
The file was not opened with write access.
MCIERR_OUTOFRANGE
The units are out of the range.
MCIERR_INVALID_MEDIA
The clipboard format is not valid.
MCIERR_INVALID_DEVICE_ID
The device ID is not valid.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INSTANCE_INACTIVE
The device is currently inactive. Issue MCI_ACQUIREDEVICE to make the device context active.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_OUT_OF_MEMORY
There is insufficient memory to perform the operation requested.
MCIERR_CLIPBOARD_EMPTY
No recognizable information is in the clipboard.
MCIERR_CANNOT_CONVERT
Unable to convert clipboard information to destination.
MMIOERR_CLIPBRD_EMPTY
There is no compatible data in the clipboard for use by the paste operation.
MMIOERR_CLIPBRD_ERROR
An unrecoverable error occurred while attempting to access the clipboard.
MMIOERR_INCOMPATIBLE_DATA
The data in the clipboard cannot be pasted into this file because the characteristics of either the video or audio data, or both, do not match the characteristics of the target file.

---

[Back] [Next]