función CLIPOBJ_bEnum (winddi.h)
La función CLIPOBJ_bEnum enumera un lote de rectángulos de una región de clip especificada; una llamada anterior a CLIPOBJ_cEnumStart determina el orden de enumeración.
Sintaxis
ENGAPI BOOL CLIPOBJ_bEnum(
[in] CLIPOBJ *pco,
[in] ULONG cj,
[out] ULONG *pul
);
Parámetros
[in] pco
Puntero a una estructura CLIPOBJ que describe la región del clip que se va a enumerar.
[in] cj
Especifica el tamaño, en bytes, del búfer al que apunta pv.
[out] pul
Puntero al búfer que recibirá datos sobre la región del clip en una estructura ENUMRECTS .
Valor devuelto
El valor devuelto es TRUE si el controlador debe llamar a esta función de nuevo para obtener más datos de enumeración o FALSE si la enumeración está completa. Es posible que CLIPOBJ_bEnum devuelva TRUE con el número de rectángulos de recorte igual a cero. En tales casos, el controlador debe llamar a CLIPOBJ_bEnum de nuevo sin realizar ninguna acción.
Comentarios
A continuación se muestra una posible estructura de bucles para llamar a esta función:
do {
bMore = CLIPOBJ_bEnum(pco, sizeof(buffer), &buffer.c);
for (i = 0; i < buffer.c; i++) {
.
.
.
}
} while (bMore);
El recuento de objetos escritos en el búfer se escribe en el propio búfer.
Requisitos
| Requisito | Value |
|---|---|
| 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 |