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.
Digital Video Extensions
The following additional flags apply to digital video devices:
MCI_DGV_WHERE_DESTINATION
This flag indicates that
the destination display rectangle should be returned in the rc field
of the data structure identified by pParam2.
MCI_DGV_WHERE_SOURCE
This flag indicates that the video source rectangle
should be returned in the rc field of the data structure identified
by pParam2.
MCI_DGV_WHERE_ADJUSTED
Used
with either MCI_DGV_WHERE_SOURCE and MCI_DGV_RECORD or MCI_DGV_WHERE_DESTINATION
and MCI_DGV_RECORD. When MCI_DGV_WHERE_ADJUSTED is specified, these commands
return the coordinates that will actually be used to record a movie or get
an image buffer based on what was set with MCI_PUT
in combination with the capabilities of the capture hardware.
MCI_DGV_WHERE_WINDOW
This flag indicates the current location of the
video window relative to its parent should be returned in the rc field
of the data structure identified by pParam2.
MCI_DGV_MONITOR
This flag indicates the window size and position
for the monitor window.
MCI_DGV_RECORD
This
flag indicates the source and destination rectangles for the video capture.
Video Overlay Extensions
The following additional flags apply to video overlay devices:
MCI_OVLY_WHERE_DESTINATION
This flag indicates
that the destination display rectangle should be returned in the rc field
of the data structure identified by pParam2.
MCI_OVLY_WHERE_SOURCE
This flag indicates that the video overlay source
rectangle should be returned in the rc field of the data structure
identified by pParam2.
MCI_OVLY_WHERE_WINDOW
This flag indicates the current location of the
video window relative to its parent should be returned in the rc field
of the data structure identified by pParam2.
pParam2 (PMCI_VID_RECT_PARMS)
A pointer to the MCI_VID_RECT_PARMS
data structure. Devices with additional parameters might replace this
pointer with a pointer to a device-specific data structure as follows:
PMCI_DGV_RECT_PARMS
PMCI_OVLY_RECT_PARMS
rc (ULONG)
Return
codes indicating success or type of failure:
MCIERR_SUCCESS
MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
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_MISSING_FLAG
Flag missing for this MMPM/2 command.
MCIERR_FLAGS_NOT_COMPATIBLE
MCIERR_INSTANCE_INACTIVE
[Back: MCI_WHERE Return Value - rc]
[Next: MCI_WHERE - Remarks]