MCI_UPDATE  XGDHDW 

The MCI_UPDATE command updates the display rectangle. Digital-video devices recognize this command.

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 Flags4FW.04J.

lpDest

Address of an MCI_GENERIC_PARMSB1BOEU 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_PAINTF55XZ2 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_PARMSFONZST structure.

See Also