MCI_UPDATE

This MCI command message repaints the current frame into the specified display context.

Parameters DWORD lParam1

The following flags apply to all devices supporting MCI_UPDATE:

MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that the operation should finish before MCI returns control to the application.

MCI_DGV_RECT

Specifies that the rc field of the data structure identified by lParam2 contains a valid display rectangle. The rectangle specifies the clipping rectangle relative to the client rectangle.

MCI_DGV_UPDATE_HDC

Specifies that the hDC field of the data structure identified by lParam2 contains a valid window of the display context to paint. This field is required.

MCI_DGV_UPDATE_PAINT

An application uses this flag when it receives a WM_PAINT message that is intended for a for a display DC. A frame buffer device will usually paint the key color. A device that does not have a frame buffer may ignore the MCI_UPDATE message when the MCI_DGV_UPDATE_PAINT flag is used if it is currently playing because the display will be repainted during the play operation.

LPMCI_DGV_UPDATE_PARMS lParam2

Specifies a far pointer to a MCI_DGV_UPDATE_PARMS data structure.

Return Value

Returns zero if successful. Otherwise, it returns an MCI error code.

Comments

When the application owns a window (that is, the application specified a window handle with the MCI_WINDOW message), it must send MCI_UPDATE whenever the window needs repainting. For example, an application uses these messages when it responds to a WM_PAINT message.

If MCI_DGV_UPDATE_HDC is used without MCI_DGV_UPDATE_PAINT, the video overlay renders the current frame into the provided HDC. Devices supporting this feature will render a full bitmap and not just update the key color.

If both MCI_DGV_UPDATE_HDC and MCI_DGV_UPDATE_PAINT are omitted, the contents of the video overlay device's frame buffer are refreshed. This is useful to show new live video data after MCI_UNFREEZE is sent to the driver from a paused state.