Функция DrvCreateDeviceBitmap (winddi.h)
Функция DrvCreateDeviceBitmap создает растровые изображения и управляет ими.
Синтаксис
HBITMAP DrvCreateDeviceBitmap(
DHPDEV dhpdev,
SIZEL sizl,
ULONG iFormat
);
Параметры
dhpdev
Дескриптор PDEV, описывающий физическое устройство, назначенное приложением в качестве основного целевого объекта для растрового изображения. Формат растрового рисунка должен быть совместим с этим физическим устройством.
sizl
Задает структуру SIZEL, содержащую ширину и высоту создаваемого растрового рисунка. Элементы cx и cy этой структуры содержат соответственно ширину и высоту растрового изображения в пикселях. Структура SIZEL идентична структуре SIZE .
iFormat
Задает формат растрового изображения, который указывает требуемое количество битов цветовой информации на пиксель и всегда соответствует формату основного. Значение может быть одним из следующих.
| Значение | Значение |
|---|---|
| BMF_8BPP | 8 бит на пиксель. |
| BMF_16BPP | 16 бит на пиксель. |
| BMF_24BPP | 24 бита на пиксель. |
| BMF_32BPP | 32 бита на пиксель. |
Возвращаемое значение
Возвращаемое значение — это дескриптор, который определяет созданное растровое изображение при успешном выполнении функции. Если драйвер решает разрешить GDI создавать растровое изображение и управлять им, возвращаемое значение равно нулю. При возникновении ошибки возвращаемое значение 0xFFFFFFFF, и GDI регистрирует код ошибки.
Комментарии
Если драйвер создает растровое изображение, он может хранить его в любом месте и в любом формате. Предполагается, что драйвер будет принимать во внимание спецификации параметров и предоставлять растровое изображение по крайней мере с таким количеством битов на пиксель, как требуется.
Содержимое созданного растрового рисунка не определено.
Эта функция является необязательной. Однако если эта функция реализована, необходимо также реализовать DrvDeleteDeviceBitmap .
Требования
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winddi.h (включая Winddi.h) |