DIB_PAL_INDICES and CBM_CREATEDIB Not Supported in Win32s

ID: Q108497

The information in this article applies to:

Microsoft Win32s versions 1.0, 1.1, and 1.2
Microsoft Win32 SDK (Windows 95 only)

The Windows NT implementation of the Win32 application programming interface (API) includes two new flags, DIB_PAL_INDICES and CBM_CREATEDIB, that can be used with various device-independent bitmap (DIB) APIs. These flags are not supported by Windows 3.1, Win32s, or Windows 95.

DIB_PAL_INDICES

In Windows NT, the DIB_PAL_INDICES flag can be used with the following APIs:

   CreateDIBitmap()
   CreateDIBPatternBrush()
   CreateDIBPatternBrushPt()
   SetDIBits()
   GetDIBits()
   SetDIBitsToDevice()
   StretchDIBits()

When the dwUsage parameter is DIB_PAL_INDICES, the associated DIB does not have a color table. In this case, the bitmap bits are indices into the device palette.

Applications written to run on Windows 3.1 or Win32s should use DIB_PAL_COLORS or DIB_RGB_COLORS instead of DIB_PAL_INDICES.

Windows 95 does not support DIB_PAL_INDICES.

CBM_CREATEDIB

In Windows 3.1, CreateDIBitmap() creates a device-dependent bitmap (DDB) from a DIB definition and optionally initializes the DDB. In Windows NT, the CBM_CREATEDIB flag can be used with CreateDIBitmap() to create a new DIB instead of a DDB.

This functionality is not present in Windows 3.1 or Win32s.

Windows 95 does not support CBM_CREATEDIB. Equivalent functionality is provided in Windows 95 by CreateDIBSection().

Additional reference words: 1.00 1.10 1.20 4.00 KBCategory: kbprg KBSubcategory: GdiBmp W32s

Last Reviewed: July 14, 1999