MCI_UPDATE
The MCI_UPDATE command updates the display rectangle. Digital-video devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_UPDATE,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpDest
);
Parameters
wDeviceID
Device identifier of the MCI device that is to receive the command message.
dwFlags
MCI_NOTIFY, MCI_WAIT, or, for digital-video devices, MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
lpDest
Pointer to an MCI_GENERIC_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)
Return Values
Returns zero if successful or an error otherwise.
Remarks
The following additional flags are used with the digitalvideo device type:
MCI_DGV_UPDATE_HDC
The hDC member of the structure identified by lpDest contains a valid window of the DC to paint. This flag is required.
MCI_DGV_RECT
The rc member of the structure identified by lpUnfreeze contains a valid display rectangle. The rectangle specifies the clipping rectangle relative to the client rectangle.
MCI_DGV_UPDATE_PAINT
An application uses this flag when it receives a WM_PAINT message that is intended for a display DC. A frame-buffer device usually paints the key color. If the display device does not have a frame buffer, it might ignore the MCI_UPDATE command when the MCI_DGV_UPDATE_PAINT flag is used because the display will be repainted during the playback operation.
For digital-video devices, the lpDest parameter points to an MCI_DGV_UPDATE_PARMS structure.
Requirements
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Mmsystem.h; include Windows.h.
See Also