MCI_REALIZE

This command message tells the device to select and realize its palette into a display context of the displayed window. This command only applies to devices which use palettes.

Parameters

DWORD lParam1

The following standard and command-specific flags apply to all devices supporting this command:


MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that the operation should finish before MCI returns control to the application.

MCI_DGV_REALIZE_BKGD

Realizes the palette as a background palette.

MCI_DGV_REALIZE_NORM

Realizes the palette normally. (This is the default.)

LPMCI_GENERIC_PARMS lParam2

Specifies a far pointer to a MCI_GENERIC_PARMS data structure.

Return Value

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

Comments

For more information, see the SelectPalette description in the Windows 3.1 Programmer's Reference.