функция CLIPOBJ_cEnumStart (winddi.h)
Функция 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 |