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 BITMAPINFOHEADER data structure that
contains information about the color format of the device-independent bitmap.
dsBitfields
Specifies
three DWORD color masks for the device-independent bitmap. This field is
only valid when the biBitCount member of the BITMAPINFOHEADER
structure has a value greater than 8. Each color mask indicates the bits within
a bit value doubleword 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 operating 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.
See Also