ICDrawRealize

The ICDrawRealize macro notifies a rendering driver to realize its drawing palette while drawing. You can use this macro or explicitly call the ICM_DRAW_REALIZE message.

DWORD ICDrawRealize(
  hic,         
  hdc,         
  fBackground  
);
 

Parameters

hic

Handle of a driver.

hdc

Handle of the DC used to realize the palette.

fBackground

Background flag. Specify TRUE to realize the palette as a background task or FALSE to realize the palette in the foreground.

Return Values

Returns ICERR_OK if the drawing palette is realized or ICERR_UNSUPPORTED if the palette associated with the decompressed data is realized.

Remarks

Drivers need to respond to this message only if the drawing palette is different from the decompressed palette.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

Video Compression Manager Overview, Video Compression Macros, ICM_DRAW_REALIZE