Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

realize command

The realize command instructs a device to select and realize its palette into the display context of the displayed window. Digital-video devices recognize this command.

To send this command, call the mciSendString function with the lpszCommand parameter set as follows.


_stprintf_s(
  lpszCommand, 
  TEXT("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
); 

Parameters

lpszDeviceID

Identifier of an MCI device. This identifier or alias is assigned when the device is opened.

lpszPalette

One of the following flags.

ValueMeaning
backgroundRealizes the palette as a background palette.
normalRealizes the palette for a top-level window. This is the default setting.

 

lpszFlags

Can be "wait", "notify", or both. For digital-video devices, "test" can also be specified. For more information about these flags, see The Wait, Notify, and Test Flags.

Return Value

Returns zero if successful or an error otherwise.

Remarks

Use this command only if your application uses a window handle and receives a WM_QUERYNEWPALLETTE or WM_PALETTECHANGED message.

Examples

The following command tells the "myvideo" device to realize its palette.

realize myvideo normal

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

See also

MCI
MCI Command Strings

 

 

Show: