функция WNDOBJ_cEnumStart (winddi.h)
Функция WNDOBJ_cEnumStart — это функция обратного вызова, которая задает параметры для перечисления прямоугольников в видимой области окна.
Синтаксис
ENGAPI ULONG WNDOBJ_cEnumStart(
WNDOBJ *pwo,
ULONG iType,
ULONG iDirection,
ULONG cLimit
);
Параметры
pwo
Указатель на структуру WNDOBJ , созданную при вызове EngCreateWnd.
iType
Указывает тип структур, возвращаемых WNDOBJ_bEnum. Этот параметр может быть CT_RECTANGLES, то есть регион должен быть перечислен в виде списка прямоугольников.
iDirection
Определяет порядок, в котором возвращаются прямоугольники. Этот порядок может иметь важное значение при выполнении перекрывающегося drvBitBlt на одной поверхности. Если заказ не относится к драйверу устройства, следует указать CD_ANY. Это позволяет GDI оптимизировать перечисление для сложных регионов. Этот параметр может иметь одно из следующих значений:
| Значение | Значение |
|---|---|
| CD_ANY | Любой заказ, удобный для GDI. |
| CD_LEFTDOWN | Справа налево, сверху вниз. |
| CD_LEFTUP | Справа налево, снизу вверх. |
| CD_LEFTWARDS | Слева направо вертикальное направление не определено. |
| CD_RIGHTDOWN | Слева направо, сверху вниз. |
| CD_RIGHTUP | Слева направо, снизу вверх. |
| CD_UPWARDS | Снизу вверх, горизонтальное направление не определено. |
cLimit
Указывает, сколько объектов требуется кеширование драйвера. Этот параметр используется только для того, чтобы решить, когда следует прекратить подсчет прямоугольников, пока GDI вычисляет возвращаемое значение для этой функции. Если cLimit равно нулю, подсчет не выполняется.
Возвращаемое значение
Возвращаемое значение — это количество объектов, которые будут перечислены, при условии, что это значение меньше или равно cLimit. Если счетчик больше cLimit, возвращаемое значение будет 0xFFFFFFFF.
Комментарии
Перечисление можно перезапустить, вызвав эту функцию еще раз.
WNDOBJ_cEnumStart следует вызывать только:
- В контексте функции обратного вызова драйвера, предоставленной GDI в функции EngCreateWnd , или графических функций DDI, где задан WNDOBJ.
- Когда вызывающий поток блокирует устройство, чтобы гарантировать, что изменения в клиентском регионе не происходят.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 2000 и более поздних версиях операционных систем Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | winddi.h (включая Winddi.h) |
| Библиотека | Win32k.lib |
| DLL | Win32k.sys |