MCI_REALIZE command
The MCI_REALIZE command causes a graphic device to realize its palette into a device context (DC). Digital-video devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_REALIZE,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpRealize
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or, for digital-video devices, MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpRealize
-
Pointer to an MCI_GENERIC_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)
Return Value
Returns zero if successful or an error otherwise.
Remarks
You should use this command when your application receives the WM_QUERYNEWPALETTE message.
The following additional flags are used with the "digitalvideo" device type:
-
MCI_DGV_REALIZE_BKGD
-
Realizes the palette as a background palette.
-
MCI_DGV_REALIZE_NORM
-
Realizes the palette normally. This is the default.
For digital-video devices, the lpRealize parameter points to an MCI_REALIZE_PARMS structure. For more information, see comments in the MCI_GENERIC_PARMS structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|