This message sets the palette or color map that is to be used for images loaded with subsequent MCI_SETIMAGEBUFFER messages.

This message does not affect motion video, an image that is already displayed, or images loaded via the MCI_RESTORE message.

This message applies only to palettized images.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_SET_REGISTERED
This flag sets the registered palette specified in the usRegisteredMap field of the MCI_PALETTE_PARMS data structure.

pParam2 (PMCI_PALETTE_PARMS)

A pointer to the MCI_PALETTE_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds.

---

[Back] [Next]