DrawDibRealize function

The DrawDibRealize function realizes the palette of the DrawDib DC for use with the specified DC.


UINT VFWAPI DrawDibRealize(
  HDC      hdc,
  BOOL     fBackground



Handle to a DrawDib DC.


Handle to the DC containing the palette.


Background palette flag. If this value is nonzero, the palette is a background palette. If this value is zero and the DC is attached to a window, the logical palette becomes the foreground palette when the window has the input focus. (A DC is attached to a window when the window class style is CS_OWNDC or when the DC is obtained by using the GetDC function.)

Return Value

Returns the number of entries in the logical palette mapped to different values in the system palette. If an error occurs or no colors were updated, it returns zero.


To select the palette of the DrawDib DC as a background palette, use the DrawDibDraw function and specify the DDF_BACKGROUNDPAL flag.


Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h
Library Vfw32.lib
DLL Msvfw32.dll

See Also

DrawDib Functions