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_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 dwFlags
            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 lpDest
 
            MCI_WAIT
                Specifies that the palette should be realized before
                MCI returns control to the application.
 
        LPMCI_GENERIC_PARMS lpDest
            Specifies a far pointer to a device specific data
            structure. For a description of this parameter, see the
            lpDest description included with the device extensions.
 
        Animation Extensions
 
        DWORD dwFlags
            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 lpDest 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 lpDest contains a handle to the display
                context. This flag is required.
 
        LPMCI_ANIM_UPDATE_PARMS lpDest
            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
 
                                       -♦-