This message requests the digital video device to capture the current movie frame and store it as an image device element.

Note: MCI_CAPTURE captures bit maps from movies rather than hardware. See MCI_GETIMAGEBUFFER for a description of how to capture from hardware with a video capture card.

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_CAPTURE_RECT
Indicates that a region of the screen to be captured is provided in the rect field of the MCI_CAPTURE_PARMS structure pointed to by pParam2.
MCI_CONVERT
Specifies that the captured image data will be converted to the OS/2 bit-map format when it is saved to disk.

pParam2 (PMCI_CAPTURE_PARMS)

A pointer to an MCI_CAPTURE_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 MMPM2 driver for this command.
MCIERR_INSTANCE_INACTIVE
The device has been opened as shareable and is currently in use by another application.
MCIERR_OVLY_INVALID_RECT
An invalid rectangle parameter was specified.
MCIERR_OVLY_NOT_AVAILABLE
The requested action is not available. (For example, because video has been set off.)

---

[Back] [Next]