Функция EngCopyBits (winddi.h)
Функция EngCopyBits преобразует растровые поверхности, управляемые устройством, и растровые изображения стандартного формата GDI.
Синтаксис
ENGAPI BOOL EngCopyBits(
SURFOBJ *psoDest,
SURFOBJ *psoSrc,
CLIPOBJ *pco,
XLATEOBJ *pxlo,
[in] RECTL *prclDest,
[in] POINTL *pptlSrc
);
Параметры
psoDest
Указатель на структуру SURFOBJ , которая описывает область назначения для операции копирования.
psoSrc
Указатель на структуру SURFOBJ, которая описывает исходную поверхность для операции копирования.
pco
Указатель на структуру CLIPOBJ , ограничивающую область поверхности назначения, которая будет затронута. Этот параметр может принимать значение NULL.
pxlo
Указатель на структуру XLATEOBJ , которая определяет преобразование цветовых индексов между исходной и целевой поверхностями.
[in] prclDest
Указатель на структуру RECTL , которая определяет область в системе координат поверхности назначения, которая будет изменена. Прямоугольник является эксклюзивным в нижнем правом углу, то есть нижний и правый края этого прямоугольника не являются частью копии.
[in] pptlSrc
Указатель на структуру POINTL , которая определяет левый верхний угол исходного прямоугольника.
Возвращаемое значение
Возвращаемое значение равно TRUE , если функция выполнена успешно. В случае неудачи он регистрирует ошибку и возвращает значение FALSE.
Комментарии
Растровые изображения стандартного формата — это одноуровневые упакованные пиксельные изображения. Каждая строка сканирования выравнивается по 4-байтовой границе. Эти растровые изображения имеют 1, 4, 8, 16, 24 или 32 бита на пиксель. Список стандартных типов форматов см. в функции EngCreateBitmap .
GDI вызывает эту функцию из своих симуляций.
EngCopyBits не следует вызывать с пустым прямоугольником назначения, а две точки прямоугольника назначения должны быть упорядочены. то есть первая точка должна представлять верхнюю левую вершину прямоугольника, а вторая — нижнюю правую вершину.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 2000 и более поздних версиях операционных систем Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | winddi.h (включая Winddi.h) |
| Библиотека | Win32k.lib |
| DLL | Win32k.sys |