Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
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 dwFlags
            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_REALIZE_BKGD
                If this flag is set, the palette is realized as a
                background palette.
 
            MCI_ANIM_REALIZE_NORM
                If this flag is set, the palette is realized normally.
                This is the default action.
 
        LPMCI_GENERIC_PARMS lpRealize
            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.
 
                                       -♦-