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_MONITOR
This flag indicates functions associated
with the MCI_WINDOW message are to be applied to the monitor window. The
monitor window output can be directed to an application-specified window
in the same manner as video playback.
MCI_DGV_WINDOW_HWND
This flag indicates the handle of the application
window to be used for video is included in the hwndDest field of
the data structure identified by pParam2.
MCI_DGV_WINDOW_DEFAULT
This flag indicates the default video window should
be used as the target for video.
MCI_DGV_WINDOW_STATE
This flag indicates the usCmdShow field
of the data structure identified by pParam2 contains one of the following
parameters for setting the window state:
- SWP_ACTIVATE
- SWP_DEACTIVATE
- SWP_HIDE
- SWP_MAXIMIZE
- SWP_MINIMIZE
- SWP_RESTORE
- SWP_SHOW
Note: The
MCI_DGV_WINDOW_STATE flag only applies to the default window and will not
affect an application-supplied alternate video window. Specifying MCI_DGV_WINDOW_DEFAULT
in conjunction with the MCI_DGV_WINDOW_STATE flag will result in an error.
MCI_DGV_WINDOW_TEXT
This
flag indicates the pszText field of the data structure identified
by pParam2 contains a pointer to a buffer containing the caption
used for the window.
Video Overlay Extensions
The following additional flags apply to video overlay devices:
MCI_OVLY_WINDOW_DEFAULT
Indicates that the default
video window should be used as the target for video.
MCI_OVLY_WINDOW_HWND
This flag indicates the handle of the application
window to be used for video. It is included in the hwndDest field
of the data structure identified by pParam2.
MCI_OVLY_WINDOW_STATE
This flag indicates the usCmdShow field
of the data structure identified by pParam2 contains a parameter
for setting the window state. Window states include:
- SWP_ACTIVATE
- SWP_DEACTIVATE
- SWP_HIDE
- SWP_MAXIMIZE
- SWP_MINIMIZE
- SWP_RESTORE
- SWP_SHOW
Note: The
MCI_OVLY_WINDOW_STATE flag only applies to the default window and will not
affect an application-supplied alternate video window.
MCI_OVLY_WINDOW_TEXT
Indicates that the pszText field of the
data structure identified by pParam2 contains a pointer to a buffer
containing the caption used for the window.
Note: The MCI_OVLY_WINDOW_TEXT flag only applies to the default
window and will not affect an application-supplied alternate video
window.
pParam2 (PMCI_VID_WINDOW_PARMS)
A pointer to the MCI_VID_WINDOW_PARMS
data structure. Devices with additional parameters might replace this
pointer with a pointer to a device-specific data structure as follows:
PMCI_DGV_WINDOW_PARMS
PMCI_OVLY_WINDOW_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_WINDOW Return Value - rc]
[Next: MCI_WINDOW - Remarks]