WNDOBJ_bEnum función (winddi.h)
La función WNDOBJ_bEnum obtiene un lote de rectángulos de la región visible de una ventana.
Sintaxis
ENGAPI BOOL WNDOBJ_bEnum(
WNDOBJ *pwo,
ULONG cj,
ULONG *pul
);
Parámetros
pwo
Puntero a una estructura WNDOBJ creada por una llamada a EngCreateWnd.
cj
Especifica el tamaño, en bytes, del búfer al que apunta pul. GDI no escribirá más allá de este límite.
pul
Puntero al búfer en el que se va a escribir una estructura del siguiente formulario. En esta estructura, c es un recuento de los rectángulos devueltos y arcl es una matriz de rectángulos:
typedef struct _ENUMRECTS{
ULONG c;
RECTL arcl[]
} ENUMRECTS;
Valor devuelto
El valor devuelto es TRUE si hay más datos que se van a enumerar y el controlador debe repetir la llamada. Es FALSE si la enumeración está completa.
Comentarios
El orden de enumeración viene determinado por la llamada a WNDOBJ_cEnumStart.
A continuación se muestra una posible estructura de bucles para llamar a esta función.
do {
bMore = WNDOBJ_bEnum(pwo, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
// Process the data
}
} while (bMore);
WNDOBJ_bEnum solo debe llamarse mediante la función de devolución de llamada proporcionada a GDI por la función EngCreateWnd o por las funciones DDI de gráficos que reciben un WNDOBJ.
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |