This message freezes the motion video on an area of the display.

ulParam1 (ULONG)

This parameter can contain 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.
Video Overlay Extensions

The following additional items apply to video overlay devices:

MCI_OVLY_FREEZE_RECT

Specifies that the rc field of the MCI_OVLY_RECT_PARMS data structure contains a valid rectangle. If this flag is not specified, the entire image is frozen.
MCI_OVLY_FREEZE_RECT_OUTSIDE
Specifies that the area outside the specified rectangle is to be affected. If this flag is not specified then the area inside is affected. This flag must be specified with the MCI_OVLY_FREEZE_RECT flag.

pParam2 (PMCI_OVLY_RECT_PARMS)

A pointer to the MCI_OVLY_RECT_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_INSTANCE_INACTIVE
Instance inactive.
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]