Функция WNDOBJ_bEnum (winddi.h)
Функция WNDOBJ_bEnum получает пакет прямоугольников из видимой области окна.
Синтаксис
ENGAPI BOOL WNDOBJ_bEnum(
WNDOBJ *pwo,
ULONG cj,
ULONG *pul
);
Параметры
pwo
Указатель на структуру WNDOBJ , созданную вызовом EngCreateWnd.
cj
Указывает размер (в байтах) буфера, на который указывает пуль. GDI не будет записывать данные, превышающие это ограничение.
pul
Указатель на буфер, в который должна быть записана структура следующей формы. В этой структуре c — это число возвращаемых прямоугольников, а arcl — массив прямоугольников:
typedef struct _ENUMRECTS{
ULONG c;
RECTL arcl[]
} ENUMRECTS;
Возвращаемое значение
Возвращаемое значение равно TRUE , если есть дополнительные данные для перечисления и драйвер должен повторить вызов. Если перечисление завершено, имеет значение FALSE .
Комментарии
Порядок перечисления определяется вызовом WNDOBJ_cEnumStart.
Ниже приведена возможная структура цикла для вызова этой функции.
do {
bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
// Process the data
}
} while (bMore);
WNDOBJ_bEnum следует вызывать только функцией обратного вызова, предоставленной GDI функцией EngCreateWnd , или графическими функциями DDI, которым предоставлен WNDOBJ.
Требования
| Минимальная версия клиента | Доступно в Windows 2000 и более поздних версиях операционных систем Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | winddi.h (включая Winddi.h) |
| Библиотека | Win32k.lib |
| DLL | Win32k.sys |