Поделиться через


Функция 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

См. также раздел

CLIPOBJ

SURFOBJ

XLATEOBJ