Функция DdCreateDIBSection (ddrawgdi.h)
[Эта функция может изменяться с каждой редакцией операционной системы. Вместо этого используйте Microsoft DirectDraw и Microsoft Direct3DAPIs; эти API изолируют приложения от таких изменений операционной системы и скрывают многие другие трудности, связанные с взаимодействием непосредственно с драйверами дисплея.]
Создает структуру DIBSECTION , которая совместно использует свою цветовую таблицу с устройством.
GdiEntry9 определяется как псевдоним для этой функции.
Синтаксис
HBITMAP DdCreateDIBSection(
HDC hdc,
const BITMAPINFO *pbmi,
UINT iUsage,
VOID **ppvBits,
HANDLE hSectionApp,
DWORD dwOffset
);
Параметры
hdc
Допустимый контроллер домена, совместимый с текущим устройством отображения.
pbmi
Указатель на структуру BITMAPINFO , которая описывает запрошенный DIBSECTION.
iUsage
Указывает тип данных, содержащихся в элементе массива bmiColors структуры BITMAPINFO , на которую указывает pbmi (индексы логической палитры или литеральные значения RGB). Определены следующие значения.
(DIB_PAL_COLORS)
Элемент bmiColors представляет собой массив 16-разрядных индексов в логической палитре контекста устройства, указанного в hdc.
(DIB_RGB_COLORS)
Структура BITMAPINFO содержит массив литеральных значений RGB.
ppvBits
Указатель на указатель на созданные данные DIBSECTION .
hSectionApp
Зарезервировано. Должно иметь значение NULL.
dwOffset
Возвращаемое значение
В случае успешного выполнения эта функция возвращает дескриптор в растровое изображение, представляющее DIBSECTION; В противном случае возвращается значение NULL.
Комментарии
Вызов этой функции обеспечивает палитру идентификаторов и отсутствие преобразования палитры при вызове IDirectDrawSurface7::Blt или StretchBlt .
Приложениям рекомендуется использовать IDirectDrawSurface7, который может создавать 8-разрядные поверхности с палитрой удостоверений, независимо от операционной системы.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | ddrawgdi.h |