This
parameter can contain any of the following:
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 supporting
MCI_PUT:
MCI_DGV_PUT_RECT
This flag specifies that the rc
field of the data structure identified by pParam2 contains a
valid display rectangle array. This is a required parameter.
MCI_DGV_PUT_SOURCE
Indicates that the rc field of the data
structure identified by pParam2 contains a display rectangle array
specifying the offset and size of a clipping rectangle for the digital video
source image. The source rectangle array specifies a capture rectangle
relative to the digital video origin. MCI_DGV_PUT_SOURCE is only valid
with the MCI_DGV_RECORD flag.
Note: The size of the origin (or source) can be found using MCI_DGV_STATUS_VIDEO_X_EXTENT
and MCI_DGV_STATUS_VIDEO_Y_EXTENT.
MCI_DGV_PUT_DESTINATION
Indicates that the rc field of the data
structure identified by pParam2 contains a display rectangle array
specifying the offset and visible extent of the digital video within the
client window. The destination rectangle array specifies a clipping rectangle
for frames relative to the lower-left corner of the window. When MCI_DGV_PUT_DESTINATION
is used with MCI_DGV_RECORD, the size of the movie to be recorded is determined
and the position is ignored. When MCI_DGV_PUT_DESTINATION is used with
MCI_DGV_MONITOR, the size and position of the monitor video relative to
the monitor window is determined. If MCI_DGV_PUT_DESTINATION is used without
either MCI_DGV_MONITOR or MCI_DGV_RECORD, the size and position of the playback
video relative to the playback window is determined.
MCI_DGV_PUT_WINDOW_MOVE
Indicates that the rc field of the data
structure identified by pParam2 contains a display rectangle specifying
the window position. All four values (X1 Y1 X2 Y2) must be specified, but
X2 and Y2 are ignored unless the MCI_DGV_PUT_WINDOW_SIZE parameter is also
specified.
MCI_DGV_PUT_WINDOW_SIZE
Indicates
that the rc field of the data structure identified by pParam2
contains a display rectangle that specifies the size of the window.
All four values (X1 Y1 X2 Y2) must be specified.
MCI_DGV_RECORD
Specifies the source and destination rectangles
for video capture.
Note: For recording, the source rectangle specifies the portion
of the image to be captured and the destination rectangle specifies the
size of the video to be recorded, thereby indicating the scaling to be applied
to the source rectangle.
MCI_DGV_MONITOR
This flag specifies the window size and position
for the monitor window.
Video Overlay Extensions
The following additional flags apply to video overlay devices:
MCI_OVLY_PUT_RECT
Specifies that the rc field
of the data structure identified by pParam2 contains a valid display
rectangle.
MCI_OVLY_PUT_DESTINATION
Indicates
that the rc field of the data structure identified by pParam2
contains a display rectangle for the video overlay within the client
window. The destination rectangle specifies a clipping rectangle for frames
relative to the lower-left corner of the window. If MCI_OVLY_PUT_DESTINATION
is specified without the MCI_OVLY_PUT_RECT flag specified, the default destination
is set.
MCI_OVLY_PUT_SOURCE
Indicates
that the rc field of the data structure identified by pParam2
contains a display rectangle for the analog video source. The source
rectangle specifies the portion of the incoming video signal which will
be displayed. If MCI_OVLY_PUT_SOURCE is specified without the MCI_OVLY_PUT_RECT
flag specified, the default source is set.
MCI_OVLY_PUT_WINDOW_MOVE
Indicates that the rc field of the data
structure identified by pParam2 contains a display rectangle, where
the X1 Y1 coordinates specify the new location of the default video window.
The coordinates are relative to the parent window. The X2 and Y2 coordinates
are ignored unless the MCI_OVLY_PUT_WINDOW_SIZE flag is also specified.
MCI_OVLY_PUT_WINDOW_SIZE
Indicates
that the rc field of the data structure identified by pParam2
contains a display rectangle. The new default window size is calculated
to ((X2 - X1) + 1) and ((Y2 - Y1) + 1).
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]
[Next]