функция CLIPOBJ_cEnumStart (winddi.h)

Статья
08/27/2023

Функция CLIPOBJ_cEnumStart задает параметры для перечисления прямоугольников в указанной области клипа.

Синтаксис

ENGAPI ULONG CLIPOBJ_cEnumStart(
  [in] CLIPOBJ *pco,
  [in] BOOL    bAll,
  [in] ULONG   iType,
  [in] ULONG   iDirection,
  [in] ULONG   cLimit
);

Параметры

[in] pco

Указатель на структуру CLIPOBJ , которая определяет перечисляемую область клипа.

[in] bAll

Указывает, следует ли перечислять весь регион. Этот параметр имеет значение TRUE , если необходимо перечислить весь регион. Если необходимо перечислить только те части, которые относятся к текущей операции рисования, имеет значение FALSE .

Драйвер, который кэширует области клипа, должен перечислять весь регион.

[in] iType

Указывает структуры данных, которые должны быть записаны CLIPOBJ_bEnum. В настоящее время этот параметр должен быть CT_RECTANGLES, указывая, что область должна быть перечислена в виде списка прямоугольников.

[in] iDirection

Определяет порядок перечисления прямоугольников. Этот порядок может быть важным, если операция DrvBitBlt выполняется параллельно на одной поверхности. Если порядок не относится к драйверу устройства, следует указать CD_ANY для сложных регионов, что позволит GDI оптимизировать перечисление. Значение может быть одним из следующих.

Значение	Значение
CD_ANY	Любой заказ, удобный для GDI.
CD_LEFTDOWN	Справа налево, сверху вниз.
CD_LEFTUP	Справа налево, снизу вверх.
CD_RIGHTDOWN	Слева направо, сверху вниз.
CD_RIGHTUP	Слева направо, снизу вверх.

[in] cLimit

Указывает максимальное число прямоугольников для перечисления. Если этот параметр равен нулю, подсчет опущен.

Возвращаемое значение

Возвращаемое значение — это количество перечисляемых прямоугольников. Если число превышает значение cLimit, возвращаемое значение будет 0xFFFFFFFF.

Требования


Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys

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

CLIPOBJ

CLIPOBJ_bEnum

DrvBitBlt

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