MCI_REALIZE (ANIMATION)

This MCI command message tells a graphic device to realize its palette into a device context. This 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_REALIZE:

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 lpRealize.

MCI_WAIT

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

MCI_ANIM_PAL_BKGD

If this flag is set, the palette is realized as a background palette.

MCI_ANIM_PAL_NORM

If this flag is set, the palette is realized normally. This is the default action.

LPMCI_GENERIC_PARMS lParam2

Specifies a far pointer to a MCI_GENERIC_PARMS data structure. (Devices with extended command sets might replace this data structure with a device-specific data structure.)

Return Value

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

Comments

This command is supported by devices that return true to the MCI_GETDEVCAPS_PALETTES query.