The digital video device uses this message to retrieve the contents of the
capture video buffer or the current movie frame. (See MCI_CAPTURE
for capturing the current movie frame without providing an application
buffer.)
Note: Video overlay devices can use this message to read the data
in the element buffer that was captured with the MCI_CAPTURE
command, obtained by the MCI_LOAD command,
or provided by the MCI_SETIMAGEBUFFER
command.
The image data is returned in the device-specific format, unless MCI_CONVERT
is specified, in which case the data is returned in OS/2 memory bitmap format.
The current values for PELFORMAT and BITSPERPEL will be used if possible.
The data will be uncompressed.
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_CONVERT
Specifies
that the image format will be converted to the OS/2 bitmap format. The
default is the device-specific format.
Digital Video
Extensions
The following flag applies to digital video devices:
MCI_USE_HW_BUFFER
If this flag is specified, a
capture will be from the capture video buffer. If this flag is not specified,
a capture will be from the movie element and not the contents of the capture
video buffer generated by MCI_CAPTURE.
Video Overlay Extensions
The following flag applies to video overlay devices:
MCI_GET_HW_BUFFER_PTR
MCI_USE_HW_BUFFER
Indicates that the hardware buffer contains the
image data.
pParam2 (PMCI_IMAGE_PARMS)
A pointer to the MCI_IMAGE_PARMS
data structure. If the pPelBuffer field in this data structure
is 0, this command is treated as a query, and the other fields in the structure
are filled in by the driver.
rc (ULONG)
Return
codes indicating success or type of failure:
MCIERR_SUCCESS
MMPM/2 command completed successfully.
MCIERR_INVALID_DEVICE_ID
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
Given flag is unsupported by this device.
MCIERR_INSTANCE_INACTIVE
MCIERR_INVALID_BUFFER
Invalid return buffer given or buffer too small.
MCIERR_FILE_NOT_FOUND
MCIERR_TARGET_DEVICE_FULL
[Back]
[Next]