MCI_UPDATE (ANIMATION)

This MCI command message updates the display rectangle. This command is part of the animation command set. The parameters and flags for this message vary according to the selected device.

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 to receive this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_WAIT

Specifies that the palette should be realized before MCI returns control to the application.

LPMCI_GENERIC_PARMS lParam2

Specifies a far pointer to a device specific data structure. For a description of this parameter, see the lParam2 description included with the device extensions.

Animation Extensions

DWORD lParam1

The following flags additional flags apply to animation devices supporting MCI_UPDATE:

MCI_ANIM_RECT

Specifies that the rc field of the data structure identified by lParam2 contains a valid rectangle. If this flag is not specified, the entire window is updated.

MCI_ANIM_UPDATE_HDC

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

LPMCI_ANIM_UPDATE_PARMS lParam2

Specifies a far pointer to a MCI_ANIM_UPDATE_PARMS data structure.

Return Value

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

See Also

MCI_PUT, MCI_WHERE