Структура DIBSECTION (wingdi.h)

Статья
03/04/2024

Структура DIBSECTION содержит сведения о DIB, созданном путем вызова функции CreateDIBSection . Структура DIBSECTION включает сведения о размерах растрового изображения, цветовом формате, цветовых масках, необязательных объектах сопоставления файлов и необязательных смещениях хранилища битовых значений. Приложение может получить заполненную структуру DIBSECTION для заданного DIB, вызвав функцию GetObject .

Синтаксис

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

Члены

dsBm

Структура данных BITMAP , содержащая сведения о DIB: его тип, размеры, цветовые емкости и указатель на его битовые значения.

dsBmih

Структура BITMAPINFOHEADER , содержащая сведения о цветовом формате DIB.

dsBitfields[3]

Задает три цветовые маски для DIB. Это поле допустимо, только если элемент BitCount структуры BITMAPINFOHEADER имеет значение больше 8. Каждая цветовая маска указывает биты, используемые для кодирования одного из трех цветовых каналов (красный, зеленый и синий).

dshSection

Содержит дескриптор объекта сопоставления файлов, который функция CreateDIBSection использовала для создания DIB. Если метод CreateDIBSection был вызван со значением NULL для параметра hSection , что приводило к выделению системой памяти для растрового изображения, то член dshSection будет иметь значение NULL.

dsOffset

Смещение битовых значений растрового рисунка в объекте сопоставления файлов, на который ссылается dshSection. Если dshSection имеет значение NULL, значение dsOffset не имеет смысла.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	wingdi.h (включая Windows.h)