This message writes data to the image capture buffer. The fields in the MCI_IMAGE_PARMS structure are used to interpret the data.

Using this message invalidates (or resets) the current element name or element HMMIO handle, since the element has been replaced by data from the application.

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 field 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_CONVERT
This flag specifies that image format conversion will be performed. Data is assumed to be in the device-specific format.

If MCI_CONVERT is specified, the data must be in the OS/2 uncompressed bit-map format.

pParam2 (PMCI_IMAGE_PARMS)

A pointer to the MCI_IMAGE_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_UNSUPPORTED_FLAG
Flag not supported by this MMPM/2 driver for this command.
MCIERR_INSTANCE_INACTIVE
Instance inactive.
MCIERR_INVALID_BUFFER
Invalid return buffer given.
MCIERR_INVALID_BUFFER
Invalid return buffer given.
MCIERR_FILE_NOT_FOUND
File not found.
MCIERR_TARGET_DEVICE_FULL
Target device is full.

---

[Back] [Next]