DIBSECTION

The DIBSECTION structure contains information about a device-independent bitmap created by calling the CreateDIBSection function. A DIBSECTION structure includes information about the bitmap's dimensions, color format, color masks, optional file mapping object, and optional bit values storage offset. An application can obtain a filled-in DIBSECTION structure for a given device-independent bitmap by calling the GetObject function.

typedef struct tagDIBSECTION { 
    BITMAP              dsBm; 
    BITMAPINFOHEADER    dsBmih; 
    DWORD               dsBitfields[3]; 
    HANDLE              dshSection; 
    DWORD               dsOffset; 
} DIBSECTION; 
 

Members

dsBm

A BITMAP data structure that contains information about the device-independent bitmap: its type, its dimensions, its color capacities, and a pointer to its bit values.

dsBmih

A bitmap information header structure that contains information about the color format of the device-independent bitmap.

Note  A bitmap information header structure may be one of the following:

Operating System	Bitmap Information Header
Windows NT 3.51 and earlier	BITMAPINFOHEADER
Windows NT 4.0 and Windows 95	BITMAPV4HEADER
Windows NT 5.0 and Windows 98	BITMAPV5HEADER.

dsBitfields

Specifies three DWORD color masks for the device-independent bitmap. This field is only valid when the BitCount member of the Bitmap Information Header structure has a value greater than 8. Each color mask indicates the bits within a DWORD that are used to encode one of the three color channels (red, green, and blue).

dshSection

Contains a handle to the file mapping object that the CreateDIBSection function used to create the device-independent bitmap. If CreateDIBSection was called with a NULL value for its hSection parameter, causing the system to allocate memory for the bitmap, the dshSection member will be NULL.

dsOffset

Specifies the offset to the bitmap's bit values within the file mapping object referenced by dshSection. If dshSection is NULL, the dsOffset value has no meaning.

QuickInfo

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

See Also

Bitmaps Overview, Bitmap Structures, BITMAP, BITMAPINFOHEADER, CreateDIBSection, GetDIBColorTable, GetObject